docs(bls): feedback

Author: nerda-codes

faq/blockstorage.mdx

@@ -56,16 +56,18 @@ Block Storage volumes are compatible with [Scaleway Instances](/compute/instance
 
 ## How can I convert a Block Storage legacy volume into a Block Storage Low Latency volume?
 
-For better performance, you can convert your Block Storage legacy volumes into Block Storage Low Latency volumes.
+Currently, there is no direct way to change the storage class of a volume while preserving its ID.
 
-To convert your volume you need to:
+However, you can use the snapshot export/import feature as a temporary solution to transition a Block Storage legacy volume into a Block Storage Low Latency volume.
 
-- Export the data: copy or back up the data from the Block storage legacy volume to an external location or intermediary storage (e.g., another temporary volume).
+    <Message type="important">
+      The process below requires manual intervention and **does not preserve the original volume's ID**.
+      While this approach allows you to transition to a Block Storage Low Latency volume, it is only a workaround.
+    </Message>
 
-- Create a Block Storage Low Latency volume
-
-- Import the data: restore or transfer the data from the backup or intermediary storage into the newly created volume.
+1. [Export a snapshot of your Block Storage legacy volume](/compute/instances/api-cli/snapshot-import-export-feature/#exporting-snapshots).
+2. [Import the snapshot into a new Low Latency volume](/compute/instances/api-cli/snapshot-import-export-feature/#importing-snapshots).
 
 Find out how to [migrate your Block Storage legacy volumes and snapshots](/compute/instances/how-to/migrate-volumes-snapshots-to-sbs/) from the Instance API to the Block Storage API.
 
-Find out about the [advantages of migrating the management of your volumes and snapshots](advantages-migrating-to-sbs) from the Instance API to the Block Storage API.
+Find out about the [advantages of migrating the management of your volumes and snapshots](/storage/block/reference-content/advantages-migrating-to-sbs) from the Instance API to the Block Storage API.

storage/block/api-cli/identifying-volume-snapshot-api.mdx

@@ -257,7 +257,7 @@ An output similar to the following should display:
     ```bash
     scw instance volume list
     ```
-    An output similar to the following whould display:
+    An output similar to the following should display:
     ```
     ID                                    STATE      SERVER ID
     b582c548-6dc0-4e77-bb93-9615b9baa380  available  a4138186-f362-41b2-adc2-c46a2e1a46b7

storage/block/how-to/identify-volume-snapshot-type.mdx

@@ -41,5 +41,4 @@ This page shows you how to identify the API that manages your volumes and snapsh
 3. Leave the **Block Storage API** filter in the drop-down or select **Instance API** to display either your snapshots managed by the Block Storage API, or the Instance API.
 4. Click the **Snapshot type** drop-down and select the snapshot type(s) to filter for.
 5. Optionally, click the <Icon name="more" /> icon next to a specific snapshot to display its information page, and verify the type next to the **Type** field.
-6. Click **Clear filters** once you are done.
-
+6. Click **Clear filters** once you are done.

storage/block/reference-content/advantages-migrating-to-sbs.mdx

@@ -15,49 +15,59 @@ categories:
 
 ## Transitioning from the Instance API to the Block Storage API for volume and snapshot management
 
-Scaleway is transitioning the management of all Block Storage legacy volumes and snapshots from the [Instance API](https://www.scaleway.com/en/developers/api/instance/) to the [Block Storage API](https://www.scaleway.com/en/developers/api/block/). All Block Storage volumes and snapshots created via the [Scaleway console](https://console.scaleway.com) will no longer be available from the [Compute section](https://console.scaleway.com/instance/), but from the [Storage section](https://console.scaleway.com/block-storage).
+Scaleway is transitioning the management of all Block Storage legacy volumes and snapshots from the [Instance API](https://www.scaleway.com/en/developers/api/instance/) to the [Block Storage API](https://www.scaleway.com/en/developers/api/block/). All Block Storage volumes and snapshots created via the [Scaleway console](https://console.scaleway.com) will no longer be available from the [Compute section](https://console.scaleway.com/instance/) but from the [Storage section](https://console.scaleway.com/block-storage).
 
-This change provides you with enhanced performance and advanced storage capabilities. If you have created volumes and snapshots via the Instance API, we **strongly recommend migrating them to the Block Storage API** to benefit from these improvements.
+This change streamlines how storage resources are managed by consolidating them under the Block Storage API, providing enhanced management features and clearer storage class distinctions. If you have created volumes and snapshots via the Instance API, we **strongly recommend transitioning to the Block Storage API** to align with the latest management practices.
 
 Local volumes will remain exclusively supported by the Instance API.
 
-## Key advantages of using the Block Storage API
+## Differences between the Instance API and the Block Storage API
 
-By migrating your Block Storage volumes and snapshots to the Block Storage API, you take advantage of the following benefits:
+The key differences between the Instance API and the Block Storage API lie in the storage classes they manage, rather than just the APIs themselves. This distinction influences the underlying hardware and performance characteristics of the volumes.
 
-- **Low latency**: volumes managed by the Block Storage API leverage modern hardware, ensuring faster access times and smoother performance.
-- **Higher IOPS performance**: benefit from up to 5K IOPS (input/output operations per second) with Block Storage Low Latency volumes and 15K IOPS with higher-tier offerings. These performance improvements are ideal for applications requiring rapid data access and high-speed operations.
+### Storage classes
 
-## Differences between volumes managed by the Instance API and the Block Storage API
+The Instance API handles only **BSSD (Basic SSD)** volumes.
+The Block Storage API supports a broader range of storage classes, including:
 
-Volumes created with the Instance API differ from those created with the Block Storage API in both hardware and performance characteristics:
+  - **BSSD volumes**
+  - **Scaleway Block Storage (SBS) 5K IOPS volumes**
+  - **Scaleway Block Storage (SBS) 15K IOPS volumes**
 
 ### Underlying hardware
 
-Instance API volumes are built on **older-generation SSDs**, resulting in **slower performance and have a higher latency**, which may impact the responsiveness of applications.
+**BSSD volumes** (managed by both APIs) are built on **older-generation SSDs**, offering reliable performance but with limitations in speed and latency.
 
-Block Storage API volumes are powered by **modern NVMe (Non-Volatile Memory Express) disks**, which are optimized for **high-speed operations**. They also have **advanced hardware** which ensures faster data access and lower latency.
+**Scaleway Block Storage 5K and 15K volumes** (managed only by the Block Storage API) are powered by **modern NVMe (Non-Volatile Memory Express) disks**. They are optimized for **low-latency and high-speed operations**.
 
-### Performance
+### Performance and latency
 
-Instance API volumes have a **limited performance** due to older SSD technology. They also have a **lower IOPS and slower data processing speed**.
+**BSSD volumes**:
 
-Block Storage API volumes benefit from e**nhanced performance with up to 15K IOPS**.
+  - **Performance**: Limited IOPS and slower data processing speed due to older SSD technology.
+  - **Latency**: Higher latency, less suitable for applications requiring rapid data retrieval.
 
-### Latency
+**Scaleway Block Storage 5K and 15K volumes**:
 
-Instance API volumes have a **higher latency**, making them less suitable for applications requiring quick data retrieval.
+  - **Performance**: Enhanced performance with up to 5K IOPS (SBS 5K) and 15K IOPS (SBS 15K).
+  - **Latency**: Lower latency, ideal for workloads demanding rapid and reliable data access.
 
-Block Storage API volumes have a **reduced latency** which ensures faster application response times. They are ideal for workloads requiring rapid and reliable data access.
+## Why transition to the Block Storage API?
 
-## Why you should migrate your volumes and snapshot
+By transitioning to the Block Storage API, you align with Scaleway's consolidated storage management approach and gain access to advanced storage features and flexibility. While migrating to the Block Storage API does not inherently change the performance of BSSD volumes, you benefit from:
 
-Currently, two APIs manage Block Storage volumes on Scaleway: the Instance API and the Scaleway Block Storage API. Maintaining both APIs for the same product is not sustainable.
+- **Unified management**: Simplified volume and snapshot management through a dedicated API.
+- **Access to advanced storage classes**: You can create new Scaleway Block Storage 5K or 15K volumes for workloads needing higher performance and lower latency.
+- **Ongoing support**: Enhanced support and updates tailored for Block Storage API-managed resources.
 
-Migrating your volumes to the Block Storage API ensures you benefit from:
+## Impact on volume names in virtual machines
 
-- The latest in storage technology with NVMe-powered performance
-- Improved reliability and scalability for your applications
-- Ongoing support and updates tailored for volumes and snapshots managed with the Block Storage API
+When transitioning to the Block Storage API, you may notice changes in how volumes are identified in your virtual machines (VMs). For more details on how devices are named and identified, please refer to [this documentation](/compute/instances/reference-content/identify-devices/).
 
-Find out [how to migrate](/compute/instances/how-to/migrate-volumes-snapshots-to-sbs/) your Block Storage legacy volumes to Block Storage Low Latency volumes.
+## How to transition
+
+For a step-by-step guide to transitioning your Block Storage legacy volumes to the Block Storage API, refer to [our migration documentation](/compute/instances/how-to/migrate-volumes-snapshots-to-sbs/).
+
+---
+
+This transition ensures Scaleway can continue to provide robust, scalable, and high-performance storage solutions tailored to your needs. If you have questions or need assistance, [contact our support team](https://console.scaleway.com/support/tickets/create).