chore(gen): documentation review MTA-5379

SamyOubouaziz · SamyOubouaziz · commit 0a766c17d4c0 · 2024-12-19T17:15:42.000+01:00
diff --git a/faq/objectstorage.mdx b/faq/objectstorage.mdx
@@ -232,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`, `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/).
+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?
  
diff --git a/storage/object/api-cli/managing-lifecycle-cliv2.mdx b/storage/object/api-cli/managing-lifecycle-cliv2.mdx
@@ -30,13 +30,22 @@ categories:
 - Downloaded [S3cmd](https://github.com/s3tools/s3cmd), [rclone](https://rclone.org/downloads/) and [mc](https://github.com/minio/mc)
 
 
-## Creating a configuration file for the Scaleway CLI
+## Creating an Object Storage configuration file for the Scaleway CLI
 
 <Message type="important">
   Unless you add a region argument to your commands, the configuration file will be set for the default region.
 </Message>
 
-1. Run the following command in a terminal to create a configuration file with `rclone`:
+<Message type="note">
+  For more information about generating a configuration file, type the following command in your terminal:
+  ```
+   scw object config get --help
+  ```
+</Message>
+
+### Configuration file for Rclone
+
+Run the following command in a terminal to create a configuration file with `rclone`:
 
     ```
     scw object config get type=rclone
@@ -61,7 +70,10 @@ categories:
     server_side_encryption =
     storage_class =
     ```
-2. Run the following command in a terminal to create a configuration file with `s3cmd`:
+
+### Configuration file for s3cmd
+
+Run the following command in a terminal to create a configuration file with `s3cmd`:
 
     ```
     scw object config get type=s3cmd
@@ -80,6 +92,9 @@ categories:
     secret_key = 12345678-1234-1234-4321-123456789123
     use_https = True
     ```
+
+### Configuration file for MinIO Client
+
 3. Run the following command in a terminal to create a configuration file with `mc`:
     ```
     scw object config get type=mc
@@ -91,12 +106,6 @@ categories:
     {"version":"9","hosts":{"scaleway":{"url":"https://s3.nl-ams.scw.cloud","accessKey":"SCW1111111111111","secretKey":"12345678-1234-1234-4321-123456789123","api":"S3v4"}}}
     ```
 
-<Message type="note">
-  For more information about generating a configuration file, type the following command in your terminal:
-  ```
-   scw object config get --help
-  ```
-</Message>
 
 ## Installing a configuration file for Amazon S3-compatible tools (s3cmd, rclone, and mc)
 
diff --git a/storage/object/how-to/create-a-bucket.mdx b/storage/object/how-to/create-a-bucket.mdx
@@ -7,7 +7,7 @@ content:
   paragraph: Create a new bucket in Scaleway Object Storage.
 tags: object storage bucket object-storage
 dates:
-  validation: 2024-06-13
+  validation: 2024-12-18
   posted: 2021-05-27
 categories:
   - storage
@@ -21,12 +21,11 @@ Object Storage allows you to store different types of objects (documents, images
 - A Scaleway account logged into the [console](https://console.scaleway.com)
 - [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
 
-
 To get started with Object Storage, you must first create a bucket. Objects are gathered into buckets. Each bucket represents a space where objects are stored.
 
 1. Click **Object Storage** on the left side menu of the console. The Object Storage dashboard displays.
 2. Click **+ Create bucket**. The bucket creation page displays.
-3. Select the geographical location in which to create your bucket.  Scaleway Object Storage is currently available in three Regions.
+3. Select the [region](/storage/object/concepts/#region-and-availability-zone) in which to create your bucket:
     - Amsterdam, The Netherlands:
       - Region: `nl-ams`
     - Paris, France:
@@ -42,8 +41,8 @@ To get started with Object Storage, you must first create a bucket. Objects are
 5. Select a use case for your bucket.
 6. Enable [bucket versioning](/storage/object/how-to/use-bucket-versioning/) if you want to store multiple versions of your objects (this may lead to higher storage costs).
 7. If applicable, you can tick the **Activate 90-day free trial** to benefit from 750 GB of free [Multi-AZ class storage](/faq/objectstorage/#what-are-the-object-storage-classes-offered-by-scaleway) for buckets in your Organization, across all regions. Refer to our [dedicated FAQ](/faq/objectstorage/#how-can-i-benefit-from-the-object-storage-free-trial) for more information.
-8. Enter a name for your bucket. 
+8. Enter a name for your bucket.
 9. Optionally, you can use the cost estimator to simulate your Object Storage costs.
 10. Click **Create bucket** to confirm. A list of your buckets displays, showing the newly created bucket.
 
-You can find more information about your bucket by clicking on its name in the **Buckets** list and then on the **Bucket settings** tab.
+You can find more information about your bucket by clicking on its name in the **Buckets** list, and then on the **Bucket settings** tab.
diff --git a/storage/object/how-to/delete-a-bucket.mdx b/storage/object/how-to/delete-a-bucket.mdx
@@ -7,7 +7,7 @@ content:
   paragraph: Delete unwanted buckets from Scaleway Object Storage.
 tags: object storage object-storage bucket
 dates:
-  validation: 2024-06-13
+  validation: 2024-12-19
   posted: 2021-01-04
 categories:
   - storage
@@ -38,4 +38,3 @@ Alternatively, you can delete a bucket by clicking the <Icon name="more" /> icon
 
 Once the bucket is deleted, it disappears from your bucket list.
 
-
diff --git a/storage/object/how-to/manage-object-visibility.mdx b/storage/object/how-to/manage-object-visibility.mdx
@@ -7,14 +7,14 @@ content:
   paragraph: Control visibility settings for objects in Object Storage.
 tags: object storage object-storage visibility
 dates:
-  validation: 2024-06-13
+  validation: 2024-12-19
   posted: 2021-05-27
 categories:
   - storage
   - object-storage
 ---
 
-Visibility specifies whether your object is visible to others or not.
+Object visibility specifies whether your object is visible to others or not, independently from [bucket visibility](/storage/object/concepts/#visibility).
 
 <Macro id="requirements" />
 
@@ -26,19 +26,39 @@ Visibility specifies whether your object is visible to others or not.
   All objects are private by default, even if they are in a public bucket. A private file in a public bucket cannot be accessed publicly.
 </Message>
 
+## Manage the visibility of a single object
+
 1. Click **Object Storage** in the **Storage** section of the side menu. The list of your buckets displays.
 2. Click the name of your bucket. A list of your objects displays.
 3. Click <Icon name="more" /> next to the selected object name.
 4. Click **Visibility**. A pop-up appears.
 5. Check **Public** or **Private** according to your preference.
 6. Click **Update object visibility** to confirm.
 
-<Message type="important">
-  You can only configure the visibility (public or private) of one object at a time. It is not possible to perform this action on an entire bucket, on which visibility is defined by default as private. Allowing public visibility of a bucket only allows the viewing of a list of objects that are stored in the bucket.
-</Message>
-
 <Message type="tip">
-If you upload a file using the CLI, you can make it public by using the `--acl public-read` parameter.
+If you upload a file using the CLI, you can make it public by using the `--acl public-read` parameter. However, [bucket policies](/storage/object/api-cli/bucket-policy/) take precedence over ACLs.
 </Message>
 
+## Manage the visibility of multiple objects
+
+You can manage the visibility of multiple ojects at a time using a [bucket policy](/storage/object/api-cli/bucket-policy/) as shown below. By allowing [GetObject](/storage/object/api-cli/object-operations/#getobject) operations to everyone, the desired objects can be accessed by any person with the link to the object.
 
+```json
+{
+  "Id": "object-visibility",
+  "Version": "2023-04-17",
+  "Statement": [
+    {
+      "Sid": "make-objects-visible",
+      "Principal": "*",
+      "Action": [
+        "s3:GetObject"
+      ],
+      "Effect": "Allow",
+      "Resource": [
+        "my-bucket/public-objects"
+        ]
+    },
+  ]
+}
+```
diff --git a/storage/object/how-to/restore-an-object-from-glacier.mdx b/storage/object/how-to/restore-an-object-from-glacier.mdx
@@ -7,7 +7,7 @@ content:
   paragraph: Retrieve objects from Glacier in Object Storage.
 tags: object-storage object storage glacier
 dates:
-  validation: 2024-06-13
+  validation: 2024-12-19
   posted: 2021-05-27
 categories:
   - storage
@@ -22,28 +22,26 @@ categories:
 - An object in [Glacier storage class](/storage/object/how-to/edit-storage-class/)
 
 <Message type="important">
-  Objects in `Glacier` can only be restored to `Standard` class.
+  Objects in Glacier can only be restored to `Standard` class.
 </Message>
 
 <Message type="tip">
-  To facilitate the steps of restoration and ensure fast restitution of your data, we recommend you store average-sized files (larger than 1 MB) in `Glacier`, as opposed to several small files.
+  To facilitate the steps of restoration and ensure fast restitution of your data, we recommend you store average-sized files (larger than 1 MB) in Glacier, as opposed to several small files.
 </Message>
 
 ## How to restore an object
 
 1. Click **Object Storage** in the **Storage** section of the side menu. The list of your buckets displays.
 
-2. Click the bucket name that contains the objects you want to restore to `STANDARD` class. The list of objects displays.
+2. Click the bucket name that contains the objects you want to restore to `Standard` class. The list of objects displays.
 
-3. Click <Icon name="more" />, then select **Restore** from the drop-down menu.
+3. Click <Icon name="more" />, then select **Restore** from the drop-down menu. A pop-up appears.
 
-    A pop-up appears.
-
-4. Enter the number of days after which the object will be transferred back to `Glacier`, or click the toggle to permanently restore the object.
+4. Enter the number of days after which the object will be transferred back to Glacier, or click the toggle to permanently restore the object.
 
 5. Click **Restore object from Glacier**.
 
-  Your object remains available in `Standard` class for the duration you specified. It will be transferred automatically back to `Glacier` once the configured period is over.
+  Your object remains available in `Standard` class for the duration you specified. It will be transferred automatically back to Glacier once the configured period is over.
 
 
 ## How to restore all objects in a bucket
@@ -77,7 +75,7 @@ The time it takes to restore an object depends on the size of the object and if
 
 For multipart objects, each part is equivalent to one object. Consequently, the more parts your object has, the longer the restore time will be.
 
-To determine how many parts a multipart object has, you can run the following `aws-cli` command:
+To determine how many parts a multipart object has, run the following `aws-cli` command:
 
 ```
 aws s3api <object-name> --bucket <bucket-name> --key b
@@ -96,5 +94,3 @@ For a multipart object, the `Etag` includes a suffix that indicates the number o
 }
 ```
 Therefore, in this example, the time it takes to restore the object (that has 14 parts) is equivalent to the time it takes to restore 14 objects.
-
-
diff --git a/storage/object/how-to/upload-files-into-a-bucket.mdx b/storage/object/how-to/upload-files-into-a-bucket.mdx
@@ -7,7 +7,7 @@ content:
   paragraph: Upload files into your Scaleway Object Storage bucket.
 tags: bucket object-storage object storage
 dates:
-  validation: 2024-06-14
+  validation: 2024-12-19
   posted: 2021-05-27
 categories:
   - storage
diff --git a/storage/object/how-to/use-bucket-versioning.mdx b/storage/object/how-to/use-bucket-versioning.mdx
@@ -7,7 +7,7 @@ content:
   paragraph: Enable and manage bucket versioning for Object Storage.
 tags: object storage object-storage bucket versioning archived
 dates:
-  validation: 2024-06-13
+  validation: 2024-12-19
   posted: 2021-05-27
 categories:
   - storage
@@ -33,7 +33,7 @@ Versioning allows you to easily recover your objects in case of unintended user
 5. Type **ENABLE** to confirm your action, then click **Enable bucket versioning** to proceed.
 
 <Message type="note">
-Once versioning is enabled, uploading an object with the same name as an existing object will create a new version of it, and will consume more storage, which may lead to higher costs.
+Once versioning is enabled, uploading an object with the same name as an existing object will create a new version of it. This new version will consume more storage, which may lead to higher costs.
 </Message>
 
 ## How to manage object versions
@@ -42,7 +42,7 @@ Once versioning is enabled, uploading an object with the same name as an existin
 2. Click the name of your selected bucket. A list of the objects it contains appears.
 3. Click <Icon name="more" /> next to the object you want to manage, then click **Versioning**. A list of the object versions displays.
 
-4. Click <Icon name="more" /> next to a non-current object version to download or permanently delete it.
+4. Click <Icon name="more" /> next to a non-current object version to download it, or permanently delete it.
 
 <Message type="note">
 To restore an object to a previous version, download the desired non-current version and upload it again. This action will replace the current version with the uploaded one. 
@@ -59,5 +59,3 @@ To restore an object to a previous version, download the desired non-current ver
 <Message type="important">
 Once versioning is suspended, no new object versions will be created. Versions created up until this point will remain stored and billable. Uploading an object with the same name as an existing object will overwrite it.
 </Message>
-
-
