fix(kafka): final modifs

RoRoJ · RoRoJ · commit c3117a3c0586 · 2025-08-21T13:38:08.000+02:00
diff --git a/pages/clusters-for-kafka/faq.mdx b/pages/clusters-for-kafka/faq.mdx
@@ -1,10 +1,10 @@
 ---
 title: Clusters for Apache Kafka® FAQ
-description: Discover Clusters for Apache Kafka® TODO
+description: Get answers to all your questions about Scaleway Clusters for Apache Kafka®
 dates:
   validation: 2025-08-20
   posted: 2025-08-20
-productIcon: TODO
+productIcon: KafkaProductIcon
 noindex: true
 ---
 
@@ -22,8 +22,8 @@ Clusters for Apache Kafka® is Scaleway's product to provide a secure, fully-man
 
 Private Beta is aimed at providing an early version of a future product, to allow users to test and validate it during its development. The following limitations apply to Clusters for Apache Kafka® in its current Private Beta phase:
 
-- Only selected users can test the product ([request an invitation](https://www.scaleway.com/en/betas/))
-- Only one Kafka version is supported (TODO).
+- Only selected users can test the product ([request an invitation](https://www.scaleway.com/en/betas/)).
+- Only one Kafka version is supported.
 - Clusters can only be provisioned with either one or three nodes (brokers).
 - The number of nodes cannot be modified after creation of the cluster.
 - Storage is fixed at 100 GB per node.
diff --git a/pages/clusters-for-kafka/how-to/manage-cluster.mdx b/pages/clusters-for-kafka/how-to/manage-cluster.mdx
@@ -14,6 +14,8 @@ Clusters for Apache Kafka® is currently in [Private Beta](https://www.scaleway.
 
 After creating your cluster, you can renew its TLS certificate, change the attached Private Network, and change its password.
 
+Other management actions, such as creating topics and events, and configuring partitions and replication factors, must be carried out via TODO HOW.
+
 <Requirements />
 
   - A Scaleway account logged into the [console](https://console.scaleway.com)
@@ -46,7 +48,11 @@ In order to facilitate connectivity to your cluster, it must always be attached
 
 3. In the **Network** panel, click **Detach Private Network**
 
-TODO
+    A pop-up displays, asking you to confirm the action.
+
+4. Click **Detach resource** to confirm.
+
+The cluster is detached, and you are returned to its **Overview** page. Click **Attach Private Network** to choose a new Private Network to attach it to. Remember that the cluster is not accessible unless it is attached to a Private Network.
 
 ## How to change the password
 
diff --git a/pages/clusters-for-kafka/index.mdx b/pages/clusters-for-kafka/index.mdx
@@ -6,12 +6,18 @@ noindex: true
 
 <ProductHeader
    productName="Clusters for Apache Kafka®"
-   productLogo="TODO"
+   productLogo="kafka"
    description="Scaleway Clusters for Apache Kafka® provides a secure, fully-managed infrastructure for your Apache Kafka® deployments."
    url="/clusters-for-kafka/quickstart/"
    label="Clusters for Apache Kafka® Quickstart"
 />
 
+<Message
+  type="note"
+  title="Clusters for Apache Kafka® is now in Public Beta">
+  This product is currently in [Private Beta](https://www.scaleway.com/en/betas/) and available to selected testers only. Watch this space to see how the product develops, or ask to join the beta for early access.
+</Message>
+
 ## Getting Started
 
 <Grid>
@@ -30,11 +36,44 @@ noindex: true
         url="/clusters-for-kafka/concepts"
     />
     <SummaryCard
-        title="How-tos"
+        title="FAQ"
+        icon="help-circle-outline"
+        description="Find answers to common questions"
+        label="View FAQ"
+        url="/clusters-for-kafka/faq/"
+    />
+    </Grid>
+
+## How-to guides
+
+    <Grid>
+    <SummaryCard
+        title="How to create a cluster"
+        icon="help-circle-outline"
+        description="Learn how to create your first cluster."
+        label="View How-to"
+        url="/clusters-for-kafka/how-to/create-cluster/"
+    />
+    <SummaryCard
+        title="How to connect to a cluster"
+        icon="help-circle-outline"
+        description="Find out how to connect your Kafka cluster."
+        label="View How-to"
+        url="/clusters-for-kafka/how-to/connect-to-cluster/"
+    />
+    <SummaryCard
+        title="How to manage a cluster"
+        icon="help-circle-outline"
+        description="Info on managing your Kafka cluster."
+        label="View How-to"
+        url="/clusters-for-kafka/how-to/manage-cluster/"
+    />
+    <SummaryCard
+        title="How to delete a cluster"
         icon="help-circle-outline"
-        description="Check our guides to add and manage your clusters"
-        label="View How-tos"
-        url="/clusters-for-kafka/how-to/"
+        description="Learn how to delete your cluster when you no longer need it"
+        label="View How-to"
+        url="/clusters-for-kafka/how-to/delete-cluster/"
     />
 
 </Grid>
@@ -43,13 +82,13 @@ noindex: true
     productLogo="cli"
     title="Clusters for Apache Kafka® API"
     description="Learn how to manage your clusters through the API."
-    url="https://www.scaleway.com/en/developers/api/TODO/"
+    url="https://www.scaleway.com/en/developers/api/clusters-for-kafka/"
     label="Go to Clusters for Apache Kafka® API"
 />
 
 ## Changelog
 
 <ChangelogList
-    productName="TODO"
+    productName="clusters-for-kafka"
     numberOfChanges={3}
 />
diff --git a/pages/clusters-for-kafka/quickstart.mdx b/pages/clusters-for-kafka/quickstart.mdx
@@ -9,6 +9,13 @@ noindex: true
 ---
 import Requirements from '@macros/iam/requirements.mdx'
 
+<Message type="note">
+Clusters for Apache Kafka® is currently in [Private Beta](https://www.scaleway.com/en/betas/) and available to selected testers only.
+</Message>
+
+Clusters for Apache Kafka® is Scaleway's product to provide a secure, fully-managed infrastructure for your Apache Kafka® deployments. With our clusters, you can create data pipelines and event-driven architectures that run natively on Apache Kafka®, without having to manage the underlying infrastructure.
+
+Follow our quickstart guide to get your first cluster up and running efficiently, and know how to delete it when you no longer need it.
 
 <Requirements />
 
@@ -17,12 +24,72 @@ import Requirements from '@macros/iam/requirements.mdx'
 
 ## How to create a Cluster for Apache Kafka®
 
-TODO
+1. Click **Apache Kafka®** in the **Data and Analytics** section of the [console](https://console.scaleway.com/) side menu. The **Clusters for Apache Kafka®a** product page displays.
+
+2. Click **Create cluster**. The creation wizard displays.
+
+3. Select a **region** for the cluster. During Private Beta, clusters are only available in the Paris region.
+
+4. Select a **Kafka® version** to run on the cluster. Only one pre-selected Kafka® version is available during Private Beta.
+
+5. Select the **number of nodes** (brokers) you want in the cluster, either **3 nodes** for a highly-available cluster enabling data replication, or **1 node** for a cluster suitable for testing and development. During Private Beta, the number of nodes cannot be changed after cluster creation.
+
+6. Select a **node type**. Choose between [dedicated or shared nodes](/clusters-for-kafka/concepts/#node), depending on your workload requirements and use case. For shared nodes, various types are available, each offering different cost-performance ratios.
+
+7. Configure **network connectivity**. During Private Beta, connectivity to clusters is facilitated exclusively through **Private Networks**. Select a Private Network from the dropdown list to attach your cluster to.
+
+8. Create **credentials** by defining a username and password. These will be used when connecting to your cluster. During Private Beta, only one user can be created per cluster, and the username is not modifiable after creation (though the password can be changed).
+
+9. Enter a **name**, and (optionally), **tags** to identify your cluster.
+
+10. Check the estimated cost summary, then click **Create cluster**.
+
+Your cluster is created, and you are taken to its **Overview** page in the console.
 
 ## How to connect to your cluster
 
-TODO
+All clients that want to connect to your cluster must:
+
+- Have downloaded the cluster's [TLS certificate](/clusters-for-kafka/how-to/manage-cluster/) and configured the client to recognize it.
+- Be [attached to a Private Network](/vpc/how-to/attach-resources-to-pn/) in the same VPC as the cluster, or connect via a [Public Gateway](/public-gateways/how-to/create-a-public-gateway/) in the VPC
+- Know the cluster's [username and password](/clusters-for-kafka/how-to/connect-to-cluster/#how-to-access-the-username-and-password)
+
+Once you have ensured the client satisfies the conditions above, you can facilitate connection via the framework of your choice. Code snippets are provided for Go, Python and Java; access them by following the steps below.
+
+1. Click **Apache Kafka®** in the **Data and Analytics** section of the [console](https://console.scaleway.com/) side menu. A list of your clusters displays.
+
+2. Click the cluster you want to connect to. Its **Overview** page displays.
+
+3. In the **Connectivity** panel, click **Connect**.
+
+    A pop-up displays, with tabs for each sample framework: **Go**, **Python** and **Java**.
+
+4. Click the tab of your choice to view the code sample.
+
+## How to configure your cluster
+
+Configuration actions that cannot currently be carried out via the Scaleway console, API or devtools include:
+
+- Creating topics, events and streams
+- Configuring cluster parameters, such as replication factors, retention policies, and partitions
+- Integrating clients and consumers
+
+These actions can be done via TODO HOW?
 
 ## How to delete a cluster
 
-TODO
+You can delete your cluster when you no longer need it.
+
+1. Click **Apache Kafka®** in the **Data and Analytics** section of the [console](https://console.scaleway.com/) side menu. A list of your clusters displays.
+
+2. Click the cluster you want to delete. Its **Overview** page displays.
+
+3. Click the **Settings** tab.
+
+4. Click **Delete cluster**.
+
+    A pop-up displays, informing you that this action will permanently delete the cluster, and all data stored on its nodes will be lost.
+
+5. Type **DELETE** in the box, and click **Delete cluster**.
+
+    The cluster is deleted, and you are returned to the product page.
