Adjustments after review

Author: joaopalet

docs/stackit_dns_record-set_update.md

@@ -4,7 +4,7 @@ Update a DNS record set
 
 ### Synopsis
 
-Update a DNS record set. Performs a partial update, i.e., fields not provided are kept unchanged.
+Update a DNS record set.
 
 ```
 stackit dns record-set update RECORD_SET_ID [flags]

docs/stackit_dns_zone_update.md

@@ -4,7 +4,7 @@ Update a DNS zone
 
 ### Synopsis
 
-Update a DNS zone. Performs a partial update, i.e., fields not provided are kept unchanged.
+Update a DNS zone.
 
 ```
 stackit dns zone update ZONE_ID [flags]

docs/stackit_organization_member_remove.md

@@ -6,7 +6,7 @@ Remove a member from an organization.
 
 Remove a member from an organization.
 A member is a combination of a subject (user, service account or client) and a role.
-The subject is usually email address for users or name in case of clients.
+The subject is usually email address (for users) or name (for clients).
 
 ```
 stackit organization member remove SUBJECT [flags]

docs/stackit_project_list.md

@@ -4,7 +4,7 @@ List STACKIT projects
 
 ### Synopsis
 
-List all STACKIT projects that match certain criteria. At least one of parent-id, project-id-like or member flag must be provided.
+List all STACKIT projects that match certain criteria.
 
 ```
 stackit project list [flags]

docs/stackit_project_member_list.md

@@ -29,7 +29,7 @@ stackit project member list [flags]
   -h, --help             Help for "stackit project member list"
       --limit int        Maximum number of entries to list
       --sort-by string   Sort entries by a specific field, one of ["subject" "role"] (default "subject")
-      --subject string   Filter by subject (Identifier of user, service account or client. Usually email address in case of users or name in case of clients)
+      --subject string   Filter by subject (the identifier of a user, service account or client). This is usually the email address (for users) or name (for clients)
 ```
 
 ### Options inherited from parent commands

docs/stackit_ske_options.md

@@ -4,7 +4,7 @@ List SKE provider options
 
 ### Synopsis
 
-List STACKIT Kubernetes Engine (SKE) provider options (availability zones, Kubernetes versions, machine images and types, volume types)
+List STACKIT Kubernetes Engine (SKE) provider options (availability zones, Kubernetes versions, machine images and types, volume types).
 Pass one or more flags to filter what categories are shown.
 
 ```

internal/cmd/dns/record-set/update/update.go

@@ -44,7 +44,7 @@ func NewCmd() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   fmt.Sprintf("update %s", recordSetIdArg),
 		Short: "Update a DNS record set",
-		Long:  "Update a DNS record set. Performs a partial update, i.e., fields not provided are kept unchanged.",
+		Long:  "Update a DNS record set.",
 		Args:  args.SingleArg(recordSetIdArg, utils.ValidateUUID),
 		Example: examples.Build(
 			examples.NewExample(

internal/cmd/dns/zone/update/update.go

@@ -54,7 +54,7 @@ func NewCmd() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   fmt.Sprintf("update %s", zoneIdArg),
 		Short: "Update a DNS zone",
-		Long:  "Update a DNS zone. Performs a partial update, i.e., fields not provided are kept unchanged.",
+		Long:  "Update a DNS zone.",
 		Args:  args.SingleArg(zoneIdArg, utils.ValidateUUID),
 		Example: examples.Build(
 			examples.NewExample(

internal/cmd/organization/member/remove/remove.go

@@ -42,7 +42,7 @@ func NewCmd() *cobra.Command {
 		Long: fmt.Sprintf("%s\n%s\n%s",
 			"Remove a member from an organization.",
 			"A member is a combination of a subject (user, service account or client) and a role.",
-			"The subject is usually email address for users or name in case of clients.",
+			"The subject is usually email address (for users) or name (for clients).",
 		),
 		Args: args.SingleArg(subjectArg, nil),
 		Example: examples.Build(

internal/cmd/project/list/list.go

@@ -44,7 +44,7 @@ func NewCmd() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "list",
 		Short: "List STACKIT projects",
-		Long:  "List all STACKIT projects that match certain criteria. At least one of parent-id, project-id-like or member flag must be provided.",
+		Long:  "List all STACKIT projects that match certain criteria.",
 		Args:  args.NoArgs,
 		Example: examples.Build(
 			examples.NewExample(