docs(baremetal): rework documentation api bare metal product (#2870)

Author: scaleway-bot

cmd/scw/testdata/test-all-usage-baremetal-bmc-get-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Get the BMC (Baseboard Management Controller) access associated with the given ID.
+Get the BMC (Baseboard Management Controller) access associated with the ID, including the URL and login information needed to connect.
 
 USAGE:
   scw baremetal bmc get [arg=value ...]

cmd/scw/testdata/test-all-usage-baremetal-bmc-start-usage.golden

@@ -1,16 +1,16 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Start BMC (Baseboard Management Controller) access associated with the given ID.
+Start BMC (Baseboard Management Controller) access associated with the ID.
 The BMC (Baseboard Management Controller) access is available one hour after the installation of the server.
-You need first to create an option Remote Access. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then you can add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. Do not forget to delete the Option.
- After start BMC, you need to Get Remote Access to get the login/password https://developers.scaleway.com/en/products/baremetal/api/#get-cefc0f.
+You need first to create an option Remote Access. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd.
+After adding the BMC option, you need to Get Remote Access to get the login/password https://developers.scaleway.com/en/products/baremetal/api/#get-cefc0f. Do not forget to delete the Option after use.
 
 USAGE:
   scw baremetal bmc start [arg=value ...]
 
 ARGS:
   server-id         ID of the server
-  ip                The IP authorized to connect to the given server
+  ip                The IP authorized to connect to the server
   [zone=fr-par-1]   Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1)
 
 FLAGS:

cmd/scw/testdata/test-all-usage-baremetal-bmc-stop-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Stop BMC (Baseboard Management Controller) access associated with the given ID.
+Stop BMC (Baseboard Management Controller) access associated with the ID.
 
 USAGE:
   scw baremetal bmc stop [arg=value ...]

cmd/scw/testdata/test-all-usage-baremetal-bmc-usage.golden

@@ -1,18 +1,18 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Baseboard Management Controller (BMC) allows you to remotely access the low-level parameters of your dedicated server.
+A Baseboard Management Controller (BMC) allows you to remotely access the low-level parameters of your dedicated server.
 For instance, your KVM-IP management console could be accessed with it.
-You need first to create an option Remote Access. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then you can add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. Do not forget to delete the Option.
+You need first to create an Remote Access option. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then you can add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. Do not forget to delete the Option.
 Then you need to create Remote Access https://developers.scaleway.com/en/products/baremetal/api/#post-1af723.
 And finally Get Remote Access to get the login/password https://developers.scaleway.com/en/products/baremetal/api/#get-cefc0f.
 
 USAGE:
   scw baremetal bmc <command>
 
 AVAILABLE COMMANDS:
-  get         Get BMC (Baseboard Management Controller) access for a given elastic metal server
-  start       Start BMC (Baseboard Management Controller) access for a given elastic metal server
-  stop        Stop BMC (Baseboard Management Controller) access for a given elastic metal server
+  get         Get BMC access
+  start       Start BMC access
+  stop        Stop BMC access
 
 FLAGS:
   -h, --help   help for bmc

cmd/scw/testdata/test-all-usage-baremetal-offer-get-usage.golden

@@ -1,12 +1,12 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Return specific offer for the given ID.
+Get details of an offer identified by its offer ID.
 
 USAGE:
   scw baremetal offer get [arg=value ...]
 
 EXAMPLES:
-  Get a server offer with the given ID
+  Get a server offer with the ID
     scw baremetal offer get zone=fr-par-1 offer-id=11111111-1111-1111-1111-111111111111
 
 ARGS:

cmd/scw/testdata/test-all-usage-baremetal-offer-list-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-List all available server offers.
+List all available Elastic Metal server configurations.
 
 USAGE:
   scw baremetal offer list [arg=value ...]
@@ -13,7 +13,7 @@ EXAMPLES:
     scw baremetal offer list zone=fr-par-1
 
 ARGS:
-  [subscription-period]   Period of subscription to filter offers (unknown_subscription_period | hourly | monthly)
+  [subscription-period]   Subscription period type to filter offers by (unknown_subscription_period | hourly | monthly)
   [zone=fr-par-1]         Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | all)
 
 FLAGS:

cmd/scw/testdata/test-all-usage-baremetal-offer-usage.golden

@@ -1,7 +1,7 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Server offers will answer with all different elastic metal server ranges available in a given zone.
-Each of them will contain all the features of the server (cpus, memories, disks) with their associated pricing.
+Server offers will answer with all different Elastic Metal server ranges available in a  zone.
+Each of them will contain all the features of the server (CPUs, memory, disks) with their associated pricing.
 
 USAGE:
   scw baremetal offer <command>

cmd/scw/testdata/test-all-usage-baremetal-options-add-usage.golden

@@ -1,12 +1,12 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Add an option to a specific server.
+Add an option, such as Private Networks, to a specific server.
 
 USAGE:
   scw baremetal options add [arg=value ...]
 
 EXAMPLES:
-  Add a given option to a server
+  Add an option, such as Private Networks, to a server
     scw baremetal options add server-id=11111111-1111-1111-1111-111111111111 option-id=11111111-1111-1111-1111-111111111111
 
 ARGS:

cmd/scw/testdata/test-all-usage-baremetal-options-delete-usage.golden

@@ -6,7 +6,7 @@ USAGE:
   scw baremetal options delete [arg=value ...]
 
 EXAMPLES:
-  Delete a given option from a server
+  Delete an option from a server
     scw baremetal options delete server-id=11111111-1111-1111-1111-111111111111 option-id=11111111-1111-1111-1111-111111111111
 
 ARGS:

cmd/scw/testdata/test-all-usage-baremetal-options-get-usage.golden

@@ -1,12 +1,12 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Return specific option for the given ID.
+Return specific option for the ID.
 
 USAGE:
   scw baremetal options get [arg=value ...]
 
 EXAMPLES:
-  Get a server option with the given ID
+  Get a server option with the ID
     scw baremetal options get zone=fr-par-1 option-id=11111111-1111-1111-1111-111111111111
 
 ARGS: