docs: harmonize API descriptions (#2070)

Author: scaleway-bot

api/account/v2/account_sdk.go

@@ -182,7 +182,7 @@ type UpdateProjectRequest struct {
 Description *string `json:"description,omitempty"`
 }
 
-// This API allows you to manage projects.
+// This API allows you to manage your Scaleway Projects.
 type API struct {
 client *scw.Client
 }

api/account/v3/account_sdk.go

@@ -182,7 +182,7 @@ type ProjectAPIUpdateProjectRequest struct {
 Description *string `json:"description,omitempty"`
 }
 
-// This API allows you to manage projects.
+// This API allows you to manage your Scaleway Projects.
 type ProjectAPI struct {
 client *scw.Client
 }

api/applesilicon/v1alpha1/applesilicon_sdk.go

@@ -453,6 +453,7 @@ type UpdateServerRequest struct {
 Name *string `json:"name,omitempty"`
 }
 
+// This API allows you to manage your Apple silicon machines.
 type API struct {
 client *scw.Client
 }

api/baremetal/v1/baremetal_sdk.go

@@ -1615,7 +1615,7 @@ type UpdateSettingRequest struct {
 Enabled *bool `json:"enabled,omitempty"`
 }
 
-// This API allows to manage your Elastic Metal server.
+// This API allows you to manage your Elastic Metal servers.
 type API struct {
 client *scw.Client
 }

api/billing/v2alpha1/billing_sdk.go

@@ -476,7 +476,7 @@ func (r *ListInvoicesResponse) UnsafeAppend(res interface{}) (uint32, error) {
 return uint32(len(results.Invoices)), nil
 }
 
-// This API allows you to query your consumption.
+// This API allows you to manage and query your Scaleway billing and consumption.
 type API struct {
 client *scw.Client
 }

api/billing/v2beta1/billing_sdk.go

@@ -799,7 +799,7 @@ func (r *ListTaxesResponse) UnsafeAppend(res interface{}) (uint64, error) {
 return uint64(len(results.Taxes)), nil
 }
 
-// This API allows you to query your consumption.
+// This API allows you to manage and query your Scaleway billing and consumption.
 type API struct {
 client *scw.Client
 }

api/block/v1alpha1/block_sdk.go

@@ -775,7 +775,7 @@ type UpdateVolumeRequest struct {
 PerfIops *uint32 `json:"perf_iops,omitempty"`
 }
 
-// This API allows you to use and manage your Block Storage volumes.
+// This API allows you to manage your Block Storage volumes.
 type API struct {
 client *scw.Client
 }

api/cockpit/v1beta1/cockpit_sdk.go

@@ -931,7 +931,7 @@ type TriggerTestAlertRequest struct {
 ProjectID string `json:"project_id"`
 }
 
-// The Cockpit API allows you to activate your Cockpit to store metrics and logs. It also provides you with a dedicated Grafana for dashboarding to visualize your metrics and logs.
+// This API allows you to manage your Scaleway Cockpit, for storing and visualizing metrics and logs.
 type API struct {
 client *scw.Client
 }

api/container/v1beta1/container_sdk.go

@@ -1605,7 +1605,7 @@ type UpdateTriggerRequest struct {
 SqsConfig *UpdateTriggerRequestSqsClientConfig `json:"sqs_config,omitempty"`
 }
 
-// Serverless Containers API.
+// This API allows you to manage your Serverless Containers.
 type API struct {
 client *scw.Client
 }

api/documentdb/v1beta1/documentdb_sdk.go

@@ -2311,6 +2311,7 @@ type UpgradeInstanceRequest struct {
 MajorUpgradeWorkflow *UpgradeInstanceRequestMajorUpgradeWorkflow `json:"major_upgrade_workflow,omitempty"`
 }
 
+// This API allows you to manage your Document Databases.
 type API struct {
 client *scw.Client
 }