chore(gen): documentation review MTA-5080 (#3745)

SamyOubouaziz · web-flow · commit ac5d1ed59693 · 2024-09-27T14:31:44.000+02:00
* chore(gen): documentation review MTA-5080

* chore(gen): update

* chore(gen): update
diff --git a/console/account/how-to/switch-account-to-corporate.mdx b/console/account/how-to/switch-account-to-corporate.mdx
@@ -7,13 +7,13 @@ content:
  paragraph: Convert your Scaleway account to a corporate account.
 tags: account personal corporate business
 dates:
- validation: 2024-03-12
+ validation: 2024-09-23
  posted: 2023-09-03
 categories:
  - console
 ---
 
-Scaleway allows you to choose between two types of accounts, Personal and Corporate. All users are given the possibility to select one or the other option when first signing up for a Scaleway account. If you signed up for a personal account and need to convert to a corporate one, follow these instructions.
+The [Scaleway console](https://console.scaleway.com) allows you to choose between two types of accounts, Personal and Corporate. All users are given the possibility to select one or the other option when first signing up for a Scaleway account. If you signed up for a personal account and need to convert to a corporate one, follow these instructions.
 
 <Message type="important">
  Switching to a corporate account is permanent. You will not be able to switch back to a personal account once the conversion to corporate is completed.
diff --git a/developer-tools/scaleway-cli/reference-content/cli-reference.mdx b/developer-tools/scaleway-cli/reference-content/cli-reference.mdx
@@ -7,7 +7,7 @@ content:
   paragraph: This page contains a list of CLI content in the Scaleway Documentation website.
 tags: devtools terraform cli scaleway-cli
 dates:
-  validation: 2024-03-18
+  validation: 2024-09-23
   posted: 2023-05-15
 categories:
   - devtools
@@ -17,12 +17,12 @@ The [Scaleway command line interface (CLI)](https://github.com/scaleway/scaleway
 
 | Product                         | Page                  |
 | ------------------------------- | --------------------- |
-| Instances                       | [Scaleway Instances CLI Cheatsheet](/compute/instances/api-cli/cli-cheatsheet/) |
+| Instances                       | [Scaleway Instances CLI cheatsheet](/compute/instances/api-cli/cli-cheatsheet/) |
 | Instances                       | [Using cloud-init with Scaleway API and CLI](/compute/instances/api-cli/using-cloud-init/) |
-| Instances                       | [Creating and managing an Instance with CLI (v2)](/compute/instances/api-cli/creating-managing-instances-with-cliv2/) |
+| Instances                       | [Creating and managing an Instance with the CLI (v2)](/compute/instances/api-cli/creating-managing-instances-with-cliv2/) |
 | Instances                       | [Managing Instance snapshots with the CLI (v2)](/compute/instances/api-cli/managing-instance-snapshot-via-cli/) |
-| Elastic Metal                   | [Creating and Managing Elastic Metal servers with the Scaleway CLI](/bare-metal/elastic-metal/api-cli/elastic-metal-with-cli/) |
+| Elastic Metal                   | [Creating and Managing Elastic Metal servers with the CLI](/bare-metal/elastic-metal/api-cli/elastic-metal-with-cli/) |
 | Messaging and Queuing           | [Using the NATS CLI](/serverless/messaging/api-cli/nats-cli/) |
-| Kubernetes                      | [Creating and managing a Kubernetes Kapsule with CLI (v2)](/containers/kubernetes/api-cli/creating-managing-kubernetes-lifecycle-cliv2/) |
-| Iot Hub                         | [Getting started with the Scaleway IoT Hub CLI](/managed-services/iot-hub/api-cli/getting-started-with-iot-hub-cli/) |
+| Kubernetes                      | [Creating and managing a Kubernetes Kapsule with the CLI (v2)](/containers/kubernetes/api-cli/creating-managing-kubernetes-lifecycle-cliv2/) |
+| Iot Hub                         | [Getting started with the IoT Hub CLI](/managed-services/iot-hub/api-cli/getting-started-with-iot-hub-cli/) |
 
diff --git a/developer-tools/scaleway-cli/reference-content/console-keyboard-shortcuts.mdx b/developer-tools/scaleway-cli/reference-content/console-keyboard-shortcuts.mdx
@@ -7,7 +7,7 @@ content:
   paragraph: This page contains the list of keyboard shortcuts to use the Scaleway console CLI
 tags: devtools cli shortcuts console
 dates:
-  validation: 2024-03-18
+  validation: 2024-08-23
   posted: 2023-11-20
 categories:
   - devtools
diff --git a/faq/objectstorage.mdx b/faq/objectstorage.mdx
@@ -7,27 +7,20 @@ content:
 hero: assets/objectstorage.webp
 tags: storage cdn object-storage
 dates:
-  validation: 2024-03-18
+  validation: 2024-09-23
 category: storage
 ---
 
 ## What is Object Storage?
 
 Object Storage is a service based on the S3 protocol. It allows you to store any kind of object (documents, images, videos, etc.).
 
-We provide you with a comfortable and integrated UI in the console for convenience. But it is not easy to browse infinite storage from the web, so we came up with some engineering trade-offs:
-Bear in mind that some actions are limited in the console for Object Storage. It includes:
+Scaleway provides an integrated UI in the [console](https://console.scaleway.com) for convenience. As browsing infinite storage through the web requires some technical trade-offs, some actions are limited in the console for Object Storage:
 
 - batch deletion is limited to 1000 objects.
 - empty files are not reported as empty folders.
 
-We provide an S3-compatible API for programmatic access or usage with any compatible software. Thus, we recommend using dedicated tools like s3cmd to manage large data sets.
-
-You can create a token in the Credentials section of the management console. To connect to Object Storage, use the Access-Key and Secret-Key displayed during token creation.
-
-<Message type="important">
-  The secret key is only shown once. Write it down and keep it safe. It cannot be recovered if you lose it.
-</Message>
+We provide an S3-compatible API for programmatic access or usage with any compatible software. Therefore, we recommend using dedicated tools such as `s3cmd` to manage large data sets.
 
 ## How am I billed for Object Storage?
 
@@ -50,7 +43,7 @@ Refer to our [Cold Storage FAQ](/faq/objectstorage/#cold-storage) for more infor
 
 ## How can I benefit from the Object Storage free trial?
 
-As a new user, you benefit from 750 GB of free [Multi-AZ class storage](/storage/object/concepts/#storage-class) for buckets in your Organization, across all [regions](/storage/object/concepts/#region-and-availability-zone).
+As a new user, you benefit from 750 GB of free [Multi-AZ class storage](/storage/object/concepts/#storage-class) for buckets in your Organization, across all [regions](/storage/object/concepts/#region-and-availability-zone), for 90 days.
 
 If you exceed 750 GB of Multi-AZ storage during the free trial period, you will only be billed for the excess data.
 
@@ -75,11 +68,11 @@ Bucket names must be unique and comply with the following:
 - Can contain lowercase letters, numbers, and hyphens.
 - Can contain a set of the 63 alphabetic characters, a to z, and the 10 Arabic numerals, 0 to 9.
 
-For buckets with a name containing a dot (.), users must use the canonical path. The subdomain form, for instance, `https://toto.tata.s3.nl-ams.scw.cloud` will not work as the SSL certificate `*.s3.nl-ams.scw.cloud` is not recursive.
+For buckets with a name containing a dot (.), users must use the canonical path. The subdomain form, for instance, `https://my.bucket.s3.nl-ams.scw.cloud` will not work as the SSL certificate `*.s3.nl-ams.scw.cloud` is not recursive.
 
-In addition, when using buckets with Secure Sockets Layer (SSL), the SSL wildcard certificate only matches buckets that do not contain periods. Therefore, it is not recommended to use bucket names with multiple dots, as it will have an impact on accessing your bucket via HTTPS. To avoid this, it is recommended to use **dashes** in your bucket names.
+In addition, when using buckets with Secure Sockets Layer (SSL), the SSL wildcard certificate only matches buckets that do not contain periods. Therefore, avoid using bucket names with multiple dots, as it will have an impact on accessing your bucket via HTTPS. Use **dashes** in your bucket names instead.
 
-Bucket names are unique in relation to our whole platform. This means **if a bucket exists already in one region, the name cannot be reused in another**.
+Bucket names are unique in our whole platform. This means **if a bucket exists already in one region, the name cannot be reused in another**.
 The `“Bucket already exists”` error message is triggered when the name you intended to use for your bucket is already reserved by another user (or yourself).
 
 <Message type="note">
@@ -99,7 +92,7 @@ Yes, you can access your files via HTTPS by creating a public link from the Scal
 
 ## Can I change HTTP headers during upload?
 
-Yes, this is allowed with tools such as `s3cmd`, but only `Cache-control` or headers prefixed by `x-amz-meta`.
+Yes, you can change HTTP headers with tools such as `s3cmd`, but only `Cache-control` or headers prefixed by `x-amz-meta`.
 
 To replace metadata using the `AWS CLI`, you can use the command below:
 ```
@@ -134,19 +127,19 @@ If your bucket has been deleted via the API, it is deleted instantly.
 Yes. Scaleway Object Storage provides `read-after-write` consistency for `PUT` and `DELETE` requests of objects in buckets in all regions. This applies to writes of new objects as well as requests overwriting existing objects and to DELETEs.
 
 `Read-after-write` consistency guarantees that changes are immediately visible (reading data) right after making those changes (writing data), meaning that a newly-created object will be visible immediately, without any delay.
-Scaleway Object Storage stores data across multiple storage systems to achieve high availability. Any read (`GET` or `LIST`) request initiated after a successful PUT request will immediately return the data written by the `PUT` request.
+Scaleway Object Storage stores data across multiple storage systems to achieve high availability. Any read (`GET` or `LIST`) request initiated after a successful `PUT` request will immediately return the data written by the `PUT` request.
 
 Examples:
 - You upload a new object into your bucket and request a listing of the objects in it: The new object will be visible in the list.
 - You delete an existing object in your bucket and try to immediately read it. Object Storage will not return any data as the object has been deleted.
 
 ## Will closing my web browser after requesting to delete a bucket stop the deletion process?
 
-No. After you click to delete a bucket in the Scaleway console, the request is processed in our backend, and it is not dependent on your web browser. For more information on how to delete a bucket, refer to the [documentation](/storage/object/how-to/delete-a-bucket/).
+No. After you click the button to delete a bucket in the Scaleway console, the request is processed in our backend, and does not depend on your web browser. For more information on how to delete a bucket, refer to the [dedicated documentation](/storage/object/how-to/delete-a-bucket/).
 
-## Can I create a bucket with the same name as that of a previously deleted one?
+## Can I create a bucket with the same name as a previously deleted one?
 
-Yes. If you have deleted a bucket via the web console, you can create a new one with the same name after a delay of 24 hours.
+Yes. If you have deleted a bucket via the Scaleway console, you can create a new one with the same name after a delay of 24 hours.
 
 ## Is there a quota limit for Object Storage?
 
@@ -176,7 +169,7 @@ No, any objects you upload into your buckets are added as Standard class objects
 
 ## I do not want to use the new Standard (Multi-AZ) class. Can I still use the old class?
 
-Unfortunately, you cannot use the old Standard class. You must use the [One Zone - IA class](/storage/object/concepts/#storage-class), which has the same behavior as the old Standard class.
+No, you cannot use the old `Standard` class. You must use the [One Zone - IA class](/storage/object/concepts/#storage-class), which has the same behavior as the old Standard class.
 
 ## Can I create a lifecycle rule to restore objects from Glacier class to One Zone - IA?
 
@@ -198,7 +191,7 @@ Yes, you simply need to [edit the storage class](/storage/object/how-to/edit-sto
 
 ## What is the cold storage Glacier class?
 
-The cold storage “Glacier” class of Object Storage gets its name in opposition to “hot data”. Hot data is the type that is frequently accessed. Cold storage is accessed less frequently and does not require fast access like hot data.
+The cold storage `Glacier` class of Object Storage gets its name in opposition to “hot data”. Hot data is the type that is frequently accessed. Cold storage is accessed less frequently and does not require fast access like hot data.
 
 ## How am I billed for Glacier cold storage?
 
@@ -239,7 +232,7 @@ Find out [how to restore an object from Glacier](/storage/object/how-to/restore-
 
 ## Can I upload an object directly to Glacier?
  
-Yes, you can select the storage class (`STANDARD` or `GLACIER`) when uploading objects using the Scaleway console. It is also possible to do so using the API. For more information, refer to our [dedicated documentation](/storage/object/how-to/edit-storage-class/).
+Yes, you can select the storage class (`STANDARD`, `One Zone IA`, or `GLACIER`) when uploading objects using the Scaleway console. It is also possible to do so using the API. For more information, refer to our [dedicated documentation](/storage/object/how-to/edit-storage-class/).
 
 ## Why are Glacier objects stored in Paris DC4? Is it accessible from buckets in all locations?
  
@@ -263,14 +256,14 @@ For example, a user wants to configure a lifecycle rule that moves an object aft
 ⇒ the object will be transferred to Glacier no later than 11:59 pm UTC on April 9th.
 
 <Message type="note">
-  When a lifecycle rule is set for a very large amount of objects (several 100000s) simultaneously, the rule might take longer to be applied.
+  When a lifecycle rule is set for a very large amount of objects (several hundreds of thousands) simultaneously, the rule can take longer to be applied.
 </Message>
 
 ## How do I encrypt my data?
  
 For increased security, we recommend you encrypt your data before sending it to Scaleway Glacier.
 Encryption should be done on the client side to guarantee that there is no evidence of your private key stored on the cluster.
-Data can be encrypted using third-party solutions, like GPG. It is possible to automatize your backups and encrypt them using a solution like Duplicity or Rclone using the crypt backend.
+Data can be encrypted using third-party solutions, like [GPG](https://gnupg.org/). It is possible to automate your backups, and encrypt them using a solution like [Duplicity](https://wiki.debian.org/Duplicity) or [Rclone crypt](https://rclone.org/crypt/).
 
 ## Can I manage my storage and archiving constraints related to the GDPR with Scaleway Glacier?
  
@@ -286,19 +279,8 @@ Lifecycle management features meet both of these requirements by allowing you to
 There is no maximum data size, Glacier accepts an unlimited number of objects up to 5 TB each.
 Large objects can be uploaded using [multipart uploads](/storage/object/api-cli/multipart-uploads/).
 
-## Why is Scaleway Glacier technology much more reliable than tape storage technologies?
- 
-Access to tape storage platforms requires a tape library to identify the cartridge on which the data is stored. Furthermore, retrieving data stored using tape storage requires reading several kilometers of tape.
- 
-Scaleway Glacier offers extra benefits compared to tape storage:
-
-- Scaleway Glacier's hard disk drive-based technology offers much better random data access time
-- Scaleway Glacier enables parallel writing to multiple disks simultaneously, providing very high read and write speeds.
-- redundancy is achieved by advanced parity mechanisms (6+3) on many media, whereas tape technology does not allow this and is limited to CRC.
-- there is no risk of mechanical part failure (ex: robot) or wear and tear (tape drive).
-
 ## Can I change the storage class of an entire bucket from Standard to Glacier?
  
-Yes, a best practice is to create a transition lifecycle rule with an empty prefix.
+Yes, a best practice is to create a [lifecycle rule](/storage/object/how-to/manage-lifecycle-rules/) targeting all objects in the bucket, or using a filter with an empty prefix.
 In this case, all files contained within the selected bucket will have their storage class altered automatically on the dates stipulated by you.
 However, due to S3 Protocol restrictions, a lifecycle rule cannot be created to modify the storage class from Glacier to Standard.
diff --git a/faq/serverless-containers.mdx b/faq/serverless-containers.mdx
@@ -6,7 +6,7 @@ content:
   h1: Serverless Containers
 hero: assets/containers.webp
 dates:
-  validation: 2024-03-18
+  validation: 2024-09-24
 category: serverless
 ---
 
@@ -76,18 +76,18 @@ Serverless Containers are billed on a pay-as-you-go basis, strictly on resource
 
 **Monthly Cost: €22.35**
 
-## How to select the right resources (vCPU/RAM) for Serverless Containers ?
+## How can I select the right resources (vCPU/RAM/ephemeral storage) for Serverless Containers ?
 
-Insufficient vCPU and RAM resources can lead to containers going to error status. Make sure to provision enough resources for your container.
+Insufficient vCPU, RAM or ephemeral storage can lead to containers going to error status. Make sure to provision enough resources for your container.
 
-We recommend you set high values, [use metrics to monitor](/serverless/containers/how-to/monitor-container/) the resource usage of your container, then adjust the value accordingly.
+We recommend you set high values, [use metrics to monitor](/serverless/containers/how-to/monitor-container/) the resource usage of your container, then adjust the values accordingly.
 
-## How to reduce cold-start of Serverless Containers ?
+## How can I reduce the cold-starts of Serverless Containers ?
 
-* **Optimize the startup**: Cold-start can be affected by a loading a large number of dependencies and opening lot of resources at startup.
+* **Optimize the startup**: Cold-starts can be affected by a loading a large number of dependencies and opening lot of resources at startup.
 Ensure that your code avoids heavy computations or long-running initialization at startup and optimize the number of loaded libraries.
 
-* **Keep your container warm**: You can use CRON triggers at certain intervals to keep your container warm or set the min-scale parameter to one when required.
+* **Keep your container warm**: You can use CRON triggers at certain intervals to keep your container warm or set the min-scale parameter to `1` when required.
 
 * **Increase resources**: Adding more vCPU and RAM can help to significantly reduce the cold-starts of your container.
 
@@ -99,11 +99,11 @@ Refer to our dedicated page about [Serverless Containers limitations and configu
 
 ## Can I whitelist the IPs of my containers?
 
-Serverless Containers does not yet support Private Networks. However, you can use the Scaleway IP ranges defined  at [https://www.scaleway.com/en/peering/](https://www.scaleway.com/en/peering/) on Managed Databases and other products that allow IP filtering.
+Serverless Containers does not yet support Private Networks. However, you can use the Scaleway IP ranges defined at [https://www.scaleway.com/en/peering/](https://www.scaleway.com/en/peering/) on Managed Databases and other products that allow IP filtering.
 
 ## How can I deploy my Containers?
 
-There are several ways to deploy containers, [this page](/serverless/containers/reference-content/deploy-container/) should help you decide which method is right for you.
+There are several ways to deploy containers. Refer to the [dedicated documentation](/serverless/containers/reference-content/deploy-container/) to determine the best method for your use case.
 
 ## Which protocols are supported by Serverless Containers?
 
diff --git a/storage/object/how-to/edit-storage-class.mdx b/storage/object/how-to/edit-storage-class.mdx
diff --git a/storage/object/how-to/get-started-edge-services.mdx b/storage/object/how-to/get-started-edge-services.mdx
