Update API descriptions for hetznercluster object

Co-authored-by: janiskemper <[email protected]> Update api/v1beta1/hetznercluster_types.go Co-authored-by: janiskemper <[email protected]>
syself · Mar 19, 2024 · bbf4ad3 · bbf4ad3
1 parent befd9c8
commit bbf4ad3
Show file tree

Hide file tree

Showing 3 changed files with 17 additions and 18 deletions.
diff --git a/api/v1beta1/hetznercluster_types.go b/api/v1beta1/hetznercluster_types.go
@@ -27,18 +27,18 @@ const (
 	// apiserver.
 	ClusterFinalizer = "hetznercluster.infrastructure.cluster.x-k8s.io"
 	// AllowEmptyControlPlaneAddressAnnotation allows HetznerCluster Webhook
-	// to skip some validation steps for external managed controle planes.
+	// to skip some validation steps for externally managed control planes.
 	AllowEmptyControlPlaneAddressAnnotation = "capi.syself.com/allow-empty-control-plane-address"
 )
 
 // HetznerClusterSpec defines the desired state of HetznerCluster.
 type HetznerClusterSpec struct {
-	// HCloudNetworkSpec defines the Network for Hetzner Cloud. If left empty no private Network is configured.
+	// HCloudNetwork defines details about the private Network for Hetzner Cloud. If left empty, no private Network is configured.
 	// +optional
 	HCloudNetwork HCloudNetworkSpec `json:"hcloudNetwork"`
 
 	// ControlPlaneRegion consists of a list of HCloud Regions (fsn, nbg, hel). Because HCloud Networks
-	// have a very low latency we could assume in some use-cases that a region is behaving like a zone
+	// have a very low latency we could assume in some use cases that a region is behaving like a zone.
 	// https://kubernetes.io/docs/reference/labels-annotations-taints/#topologykubernetesiozone
 	ControlPlaneRegions []Region `json:"controlPlaneRegions"`
 
@@ -48,7 +48,7 @@ type HetznerClusterSpec struct {
 	// +optional
 	ControlPlaneEndpoint *clusterv1.APIEndpoint `json:"controlPlaneEndpoint,omitempty"`
 
-	// ControlPlaneLoadBalancer is optional configuration for customizing control plane behavior. Naming convention is from upstream cluster-api project.
+	// ControlPlaneLoadBalancer is an optional configuration for customizing control plane behavior.
 	ControlPlaneLoadBalancer LoadBalancerSpec `json:"controlPlaneLoadBalancer,omitempty"`
 
 	// +optional

diff --git a/config/crd/bases/infrastructure.cluster.x-k8s.io_hetznerclusters.yaml b/config/crd/bases/infrastructure.cluster.x-k8s.io_hetznerclusters.yaml
@@ -82,9 +82,8 @@ spec:
                 - port
                 type: object
               controlPlaneLoadBalancer:
-                description: ControlPlaneLoadBalancer is optional configuration for
-                  customizing control plane behavior. Naming convention is from upstream
-                  cluster-api project.
+                description: ControlPlaneLoadBalancer is an optional configuration
+                  for customizing control plane behavior.
                 properties:
                   algorithm:
                     allOf:
@@ -160,8 +159,8 @@ spec:
               controlPlaneRegions:
                 description: ControlPlaneRegion consists of a list of HCloud Regions
                   (fsn, nbg, hel). Because HCloud Networks have a very low latency
-                  we could assume in some use-cases that a region is behaving like
-                  a zone https://kubernetes.io/docs/reference/labels-annotations-taints/#topologykubernetesiozone
+                  we could assume in some use cases that a region is behaving like
+                  a zone. https://kubernetes.io/docs/reference/labels-annotations-taints/#topologykubernetesiozone
                 items:
                   description: Region is a Hetzner Location
                   enum:
@@ -173,8 +172,8 @@ spec:
                   type: string
                 type: array
               hcloudNetwork:
-                description: HCloudNetworkSpec defines the Network for Hetzner Cloud.
-                  If left empty no private Network is configured.
+                description: HCloudNetwork defines details about the private Network
+                  for Hetzner Cloud. If left empty, no private Network is configured.
                 properties:
                   cidrBlock:
                     default: 10.0.0.0/16

diff --git a/config/crd/bases/infrastructure.cluster.x-k8s.io_hetznerclustertemplates.yaml b/config/crd/bases/infrastructure.cluster.x-k8s.io_hetznerclustertemplates.yaml
@@ -103,9 +103,8 @@ spec:
                         - port
                         type: object
                       controlPlaneLoadBalancer:
-                        description: ControlPlaneLoadBalancer is optional configuration
-                          for customizing control plane behavior. Naming convention
-                          is from upstream cluster-api project.
+                        description: ControlPlaneLoadBalancer is an optional configuration
+                          for customizing control plane behavior.
                         properties:
                           algorithm:
                             allOf:
@@ -182,8 +181,8 @@ spec:
                       controlPlaneRegions:
                         description: ControlPlaneRegion consists of a list of HCloud
                           Regions (fsn, nbg, hel). Because HCloud Networks have a
-                          very low latency we could assume in some use-cases that
-                          a region is behaving like a zone https://kubernetes.io/docs/reference/labels-annotations-taints/#topologykubernetesiozone
+                          very low latency we could assume in some use cases that
+                          a region is behaving like a zone. https://kubernetes.io/docs/reference/labels-annotations-taints/#topologykubernetesiozone
                         items:
                           description: Region is a Hetzner Location
                           enum:
@@ -195,8 +194,9 @@ spec:
                           type: string
                         type: array
                       hcloudNetwork:
-                        description: HCloudNetworkSpec defines the Network for Hetzner
-                          Cloud. If left empty no private Network is configured.
+                        description: HCloudNetwork defines details about the private
+                          Network for Hetzner Cloud. If left empty, no private Network
+                          is configured.
                         properties:
                           cidrBlock:
                             default: 10.0.0.0/16