docs(apple): reworked apple silicon api doc (#2867)

Author: scaleway-bot

cmd/scw/testdata/test-all-usage-apple-silicon-os-get-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Get an Operating System (OS).
+Get an Operating System (OS).  The response will include the OS's unique ID as well as its name and label.
 
 USAGE:
   scw apple-silicon os get <os-id ...> [arg=value ...]

cmd/scw/testdata/test-all-usage-apple-silicon-os-list-usage.golden

@@ -1,13 +1,13 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-List all Operating System (OS).
+List all Operating System (OS). The response will include the total number of OS as well as their associated IDs, names and labels.
 
 USAGE:
   scw apple-silicon os list [arg=value ...]
 
 ARGS:
-  [server-type]     List of compatible server type
-  [name]            Filter os by name (for eg. "11.1" will return "11.1.2" and "11.1" but not "12")
+  [server-type]     List of compatible server types
+  [name]            Filter OS by name (note that "11.1" will return "11.1.2" and "11.1" but not "12"))
   [zone=fr-par-1]   Zone to target. If none is passed will use default zone from the config (fr-par-3 | all)
 
 FLAGS:

cmd/scw/testdata/test-all-usage-apple-silicon-server-create-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Create a server.
+Create a new server in the targeted zone, specifying its configuration including name and type.
 
 USAGE:
   scw apple-silicon server create [arg=value ...]

cmd/scw/testdata/test-all-usage-apple-silicon-server-delete-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Delete a server.
+Delete an existing Apple silicon server, specified by its server ID. Deleting a server is permanent, and cannot be undone. Note that the minimum allocation period for Apple silicon-as-a-service is 24 hours, meaning you cannot delete your server prior to that.
 
 USAGE:
   scw apple-silicon server delete <server-id ...> [arg=value ...]

cmd/scw/testdata/test-all-usage-apple-silicon-server-get-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Get a server.
+Retrieve information about an existing Apple silicon server, specified by its server ID. Its full details, including name, status and IP address, are returned in the response object.
 
 USAGE:
   scw apple-silicon server get <server-id ...> [arg=value ...]

cmd/scw/testdata/test-all-usage-apple-silicon-server-list-usage.golden

@@ -1,14 +1,14 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-List all servers.
+List all servers in the specified zone. By default, returned servers in the list are ordered by creation date in ascending order, though this can be modified via the `order_by` field.
 
 USAGE:
   scw apple-silicon server list [arg=value ...]
 
 ARGS:
-  [order-by]          The sort order of the returned servers (created_at_asc | created_at_desc)
-  [project-id]        List only servers of this project ID
-  [organization-id]   List only servers of this organization ID
+  [order-by]          Sort order of the returned servers (created_at_asc | created_at_desc)
+  [project-id]        Only list servers of this project ID
+  [organization-id]   Only list servers of this Organization ID
   [zone=fr-par-1]     Zone to target. If none is passed will use default zone from the config (fr-par-3 | all)
 
 FLAGS:

cmd/scw/testdata/test-all-usage-apple-silicon-server-reboot-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Reboot a server.
+Reboot an existing Apple silicon server, specified by its server ID.
 
 USAGE:
   scw apple-silicon server reboot <server-id ...> [arg=value ...]

cmd/scw/testdata/test-all-usage-apple-silicon-server-reinstall-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Reinstall a server.
+Reinstall an existing Apple silicon server (specified by its server ID) from a new image (OS). All the data on the disk is deleted and all configuration is reset to the defailt configuration values of the image (OS).
 
 USAGE:
   scw apple-silicon server reinstall <server-id ...> [arg=value ...]

cmd/scw/testdata/test-all-usage-apple-silicon-server-type-list-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-List all server types technical details.
+List all technical details about Apple silicon server types available in the specified zone. Since there is only one Availability Zone for Apple silicon servers, the targeted value is `fr-par-3`.
 
 USAGE:
   scw apple-silicon server-type list [arg=value ...]

cmd/scw/testdata/test-all-usage-apple-silicon-server-update-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Update a server.
+Update the parameters of an existing Apple silicon server, specified by its server ID.
 
 USAGE:
   scw apple-silicon server update <name ...> [arg=value ...]