docs: fix list item description

docs/docs/api-reference/cassandra.md

@@ -234,7 +234,7 @@ cassandra configuration values.
 
 _Appears on [`spec.userConfig`](#spec.userConfig)._
 
-Allow incoming connections from CIDR address block, e.g. `10.20.0.0/16`.
+CIDR address block, either as a string, or in a dict with an optional description field.
 
 **Required**
 

docs/docs/api-reference/clickhouse.md

@@ -214,7 +214,7 @@ OpenSearch specific user configuration options.
 
 _Appears on [`spec.userConfig`](#spec.userConfig)._
 
-Allow incoming connections from CIDR address block, e.g. `10.20.0.0/16`.
+CIDR address block, either as a string, or in a dict with an optional description field.
 
 **Required**
 

docs/docs/api-reference/clickhousegrant.md

@@ -202,7 +202,8 @@ Authentication reference to Aiven token in a secret.
 
 _Appears on [`spec`](#spec)._
 
-Configuration to grant a privilege. Privileges not in the manifest are revoked. Existing privileges are retained; new ones are granted.
+PrivilegeGrant represents the privileges to be granted to users or roles.
+See https://clickhouse.com/docs/en/sql-reference/statements/grant#granting-privilege-syntax.
 
 **Required**
 
@@ -223,7 +224,7 @@ See https://clickhouse.com/docs/en/sql-reference/statements/grant#granting-privi
 
 _Appears on [`spec.privilegeGrants`](#spec.privilegeGrants)._
 
-List of grantees (users or roles) to grant the privilege to.
+Grantee represents a user or a role to which privileges or roles are granted.
 
 **Optional**
 
@@ -234,7 +235,8 @@ List of grantees (users or roles) to grant the privilege to.
 
 _Appears on [`spec`](#spec)._
 
-Configuration to grant a role. Role grants not in the manifest are revoked. Existing role grants are retained; new ones are granted.
+RoleGrant represents the roles to be assigned to users or roles.
+See https://clickhouse.com/docs/en/sql-reference/statements/grant#assigning-role-syntax.
 
 **Required**
 
@@ -250,7 +252,7 @@ See https://clickhouse.com/docs/en/sql-reference/statements/grant#admin-option.
 
 _Appears on [`spec.roleGrants`](#spec.roleGrants)._
 
-List of grantees (users or roles) to grant the privilege to.
+Grantee represents a user or a role to which privileges or roles are granted.
 
 **Optional**
 

docs/docs/api-reference/grafana.md

@@ -372,7 +372,7 @@ External image store settings.
 
 _Appears on [`spec.userConfig`](#spec.userConfig)._
 
-Allow incoming connections from CIDR address block, e.g. `10.20.0.0/16`.
+CIDR address block, either as a string, or in a dict with an optional description field.
 
 **Required**
 

docs/docs/api-reference/kafka.md

@@ -230,7 +230,7 @@ Kafka specific user configuration options.
 
 _Appears on [`spec.userConfig`](#spec.userConfig)._
 
-Allow incoming connections from CIDR address block, e.g. `10.20.0.0/16`.
+CIDR address block, either as a string, or in a dict with an optional description field.
 
 **Required**
 
@@ -335,7 +335,7 @@ Kafka Connect configuration values.
 
 _Appears on [`spec.userConfig`](#spec.userConfig)._
 
-Configure external secret providers in order to reference external secrets in connector configuration. Currently Hashicorp Vault (provider: vault, auth_method: token) and AWS Secrets Manager (provider: aws, auth_method: credentials) are supported. Secrets can be referenced in connector config with ${<provider_name>:<secret_path>:<key_name>}.
+SecretProvider.
 
 **Required**
 

docs/docs/api-reference/kafkaconnect.md

@@ -151,7 +151,7 @@ KafkaConnect specific user configuration options.
 
 _Appears on [`spec.userConfig`](#spec.userConfig)._
 
-Allow incoming connections from CIDR address block, e.g. `10.20.0.0/16`.
+CIDR address block, either as a string, or in a dict with an optional description field.
 
 **Required**
 
@@ -224,7 +224,7 @@ Allow access to selected service ports from the public Internet.
 
 _Appears on [`spec.userConfig`](#spec.userConfig)._
 
-Configure external secret providers in order to reference external secrets in connector configuration. Currently Hashicorp Vault (provider: vault, auth_method: token) and AWS Secrets Manager (provider: aws, auth_method: credentials) are supported. Secrets can be referenced in connector config with ${<provider_name>:<secret_path>:<key_name>}.
+SecretProvider.
 
 **Required**
 

docs/docs/api-reference/mysql.md

@@ -227,7 +227,7 @@ MySQL specific user configuration options.
 
 _Appears on [`spec.userConfig`](#spec.userConfig)._
 
-Allow incoming connections from CIDR address block, e.g. `10.20.0.0/16`.
+CIDR address block, either as a string, or in a dict with an optional description field.
 
 **Required**
 

docs/docs/api-reference/opensearch.md

@@ -218,7 +218,7 @@ OpenSearch specific user configuration options.
 
 _Appears on [`spec.userConfig`](#spec.userConfig)._
 
-Index patterns.
+Allows you to create glob style patterns and set a max number of indexes matching this pattern you want to keep. Creating indexes exceeding this value will cause the oldest one to get deleted. You could for example create a pattern looking like `logs.?` and then create index logs.1, logs.2 etc, it will delete logs.1 once you create logs.6. Do note `logs.?` does not apply to logs.10. Note: Setting max_index_count to 0 will do nothing and the pattern gets ignored.
 
 **Required**
 
@@ -245,7 +245,7 @@ Template settings for all new indexes.
 
 _Appears on [`spec.userConfig`](#spec.userConfig)._
 
-Allow incoming connections from CIDR address block, e.g. `10.20.0.0/16`.
+CIDR address block, either as a string, or in a dict with an optional description field.
 
 **Required**
 

docs/docs/api-reference/postgresql.md

@@ -233,7 +233,7 @@ PostgreSQL specific user configuration options.
 
 _Appears on [`spec.userConfig`](#spec.userConfig)._
 
-Allow incoming connections from CIDR address block, e.g. `10.20.0.0/16`.
+CIDR address block, either as a string, or in a dict with an optional description field.
 
 **Required**
 

docs/docs/api-reference/redis.md

@@ -222,7 +222,7 @@ Redis specific user configuration options.
 
 _Appears on [`spec.userConfig`](#spec.userConfig)._
 
-Allow incoming connections from CIDR address block, e.g. `10.20.0.0/16`.
+CIDR address block, either as a string, or in a dict with an optional description field.
 
 **Required**
 

docs/docs/api-reference/serviceintegration.md

@@ -295,7 +295,7 @@ Clickhouse Kafka configuration values.
 
 _Appears on [`spec.clickhouseKafka`](#spec.clickhouseKafka)._
 
-Tables to create.
+Table to create.
 
 **Required**
 
@@ -320,7 +320,7 @@ Tables to create.
 
 _Appears on [`spec.clickhouseKafka.tables`](#spec.clickhouseKafka.tables)._
 
-Table columns.
+Table column.
 
 **Required**
 
@@ -331,7 +331,7 @@ Table columns.
 
 _Appears on [`spec.clickhouseKafka.tables`](#spec.clickhouseKafka.tables)._
 
-Kafka topics.
+Kafka topic.
 
 **Required**
 
@@ -351,7 +351,7 @@ Clickhouse PostgreSQL configuration values.
 
 _Appears on [`spec.clickhousePostgresql`](#spec.clickhousePostgresql)._
 
-Databases to expose.
+Database to expose.
 
 **Optional**
 
@@ -383,7 +383,7 @@ Datadog specific user configuration options.
 
 _Appears on [`spec.datadog`](#spec.datadog)._
 
-Custom tags provided by user.
+Datadog tag defined by user.
 
 **Required**
 
@@ -431,7 +431,7 @@ External AWS CloudWatch Metrics integration Logs configuration values.
 
 _Appears on [`spec.externalAWSCloudwatchMetrics`](#spec.externalAWSCloudwatchMetrics)._
 
-Metrics to not send to AWS CloudWatch (takes precedence over extra_metrics).
+Metric name and subfield.
 
 **Required**
 
@@ -442,7 +442,7 @@ Metrics to not send to AWS CloudWatch (takes precedence over extra_metrics).
 
 _Appears on [`spec.externalAWSCloudwatchMetrics`](#spec.externalAWSCloudwatchMetrics)._
 
-Metrics to allow through to AWS CloudWatch (in addition to default metrics).
+Metric name and subfield.
 
 **Required**
 

docs/docs/api-reference/serviceintegrationendpoint.md

@@ -144,7 +144,7 @@ Datadog configuration values.
 
 _Appears on [`spec.datadog`](#spec.datadog)._
 
-Custom tags provided by user.
+Datadog tag defined by user.
 
 **Required**
 

generators/docs/generator.go

@@ -160,7 +160,10 @@ func (s *schemaType) init() {
 		s.Items.Name = s.Name
 		s.Items.level = s.level
 		s.Items.parent = s.parent
-		s.Items.Description = s.Description
+		if s.Items.Description == "" {
+			// Takes parent description if doesn't have one
+			s.Items.Description = s.Description
+		}
 		s.Items.init()
 	}