docs(file): review File Storage API descriptions and documentation MTA-6002 (scaleway#4714)

Co-authored-by: Rémy Léone <rleone@scaleway.com>
Co-authored-by: Laure-di <62625835+Laure-di@users.noreply.github.com>
Co-authored-by: Laure-di <lmasson@scaleway.com>

Author: 3 people

internal/namespaces/file/v1alpha1/file_cli.go

@@ -89,9 +89,8 @@ func fileFilesystemGet() *core.Command {
 
 func fileFilesystemList() *core.Command {
 	return &core.Command{
-		Short: `List all filesystems`,
-		Long: `Retrieve all filesystems in the specified region. Results are ordered by creation date in ascending order by default.
-Use the order_by parameter to modify the sorting behavior.`,
+		Short:     `List all filesystems`,
+		Long:      `Retrieve all filesystems in the specified region. By default, the filesystems listed are ordered by creation date in ascending order. This can be modified using the ` + "`" + `order_by` + "`" + ` field.`,
 		Namespace: "file",
 		Resource:  "filesystem",
 		Verb:      "list",
@@ -120,7 +119,7 @@ Use the order_by parameter to modify the sorting behavior.`,
 			},
 			{
 				Name:       "name",
-				Short:      `Filter the return filesystems by their names`,
+				Short:      `Filter the returned filesystems by their names`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,
@@ -161,8 +160,7 @@ func fileAttachmentList() *core.Command {
 	return &core.Command{
 		Short: `List filesystems attachments`,
 		Long: `List all existing attachments in a specified region.
-By default, the attachments listed are ordered by creation date in ascending order.
-This can be modified using the ` + "`" + `order_by` + "`" + ` field.`,
+By default, the attachments listed are ordered by creation date in ascending order. This can be modified using the ` + "`" + `order_by` + "`" + ` field.`,
 		Namespace: "file",
 		Resource:  "attachment",
 		Verb:      "list",
@@ -229,7 +227,7 @@ This can be modified using the ` + "`" + `order_by` + "`" + ` field.`,
 func fileFilesystemCreate() *core.Command {
 	return &core.Command{
 		Short:     `Create a new filesystem`,
-		Long:      `To create a new filesystem, you need to provide a name, a size, and a project ID.`,
+		Long:      `To create a new filesystem, you must specify a name, a size, and a project ID.`,
 		Namespace: "file",
 		Resource:  "filesystem",
 		Verb:      "create",

internal/namespaces/key_manager/v1alpha1/key_manager_cli.go

@@ -8,7 +8,7 @@ import (
 	"reflect"
 
 	"github.com/scaleway/scaleway-cli/v2/core"
-	"github.com/scaleway/scaleway-sdk-go/api/key_manager/v1alpha1"
+	key_manager "github.com/scaleway/scaleway-sdk-go/api/key_manager/v1alpha1"
 	"github.com/scaleway/scaleway-sdk-go/scw"
 )