feat(gen): use case filters MTA-6418b

macros/ai/chat-comp-vs-responses-api.mdx

@@ -6,10 +6,10 @@ Both the [Chat Completions API](https://www.scaleway.com/en/developers/api/gener
 
 The **Chat Completions** API was released in 2023, and is an industry standard for building AI applications, being specifically designed for handling multi-turn conversations. It is stateless, but allows users to manage conversation history by appending each new message to the ongoing conversation. Messages in the conversation can include text, images and audio extracts. The API supports `function` tool-calling, allowing developers to define functions that the model can choose to call. If it does so, it returns the function name and arguments, which the developer's code must execute and feed back into the conversation.
 
-The **Responses** API was released in 2025, and is designed to combine the simplicity of Chat Completions with the ability to do more agentic tasks and reasoning. It supports statefulness, being able to maintain context without needing to resend the entire conversation history. It offers tool-calling by built-in tools (e.g. web or file search) that the model is able to execute itself while generating a response. 
+The **Responses** API was released in 2025, and is designed to combine the simplicity of Chat Completions with the ability to do more agentic tasks and reasoning. It supports statefulness, being able to maintain context without needing to resend the entire conversation history. It offers tool-calling by built-in tools (e.g. web or file search) that the model is able to execute itself while generating a response.
 
 <Message type="note">
-Scaleway's support for the Responses API is currently at beta stage. Support of the full feature set will be incremental: currently statefulness and tools other than `function` calling are not supported. 
+Scaleway's support for the Responses API is currently at beta stage. Support of the full feature set will be incremental: currently statefulness and tools other than `function` calling are not supported.
 </Message>
 
 Most supported Generative API models can be used with both Chat Completions and Responses API. For the `gpt-oss-120b` model, use of the Responses API is recommended, as it will allow you to access all of its features, especially tool-calling.

menu/mainLinks.json

@@ -10,6 +10,11 @@
       "label": "Tutorials",
       "slug": "tutorials"
     },
+    {
+      "icon": "UseCasesCategoryIcon",
+      "label": "Use cases",
+      "slug": "use-cases"
+    },
     {
       "icon": "BillingCategoryIcon",
       "label": "Troubleshooting Hub",

pages/use-cases/application-hosting/index.mdx

@@ -0,0 +1,28 @@
+---
+title: Host an application
+description: Seamlessly deploy and host your applications on Scaleway's scalable cloud infrastructure.
+---
+
+## Host an application at Scaleway
+Looking to deploy a web application? Scaleway offers scalable and secure hosting solutions to support your app development and deployment. Whether you're building a small prototype or a full-scale enterprise application, we have the resources you need.
+
+<Grid>
+    <SummaryCard
+        title="Choosing the best Instance for your workload"
+        icon="rocket"
+        description="Understand the different ranges of Instances available at Scaleway to choose the best on for your app hosting project."
+        label="Read more"
+        url="/instances/reference-content/choosing-instance-type/"
+    />
+    <SummaryCard
+        title="Deploying a SaaS application with Scaleway"
+        icon="info"
+        description="Combine different Scaleway products to build an application infrastructure."
+        label="Read more"
+        url="/tutorials/deploy-saas-application/"
+    />
+</Grid>
+
+## Related tutorials
+
+<UseCaseList category="application-hosting" />

pages/use-cases/back-up-data/index.mdx

@@ -0,0 +1,28 @@
+---
+title: Backup and archive data
+description: Discover how to safeguard your data with different backup and archival solutions.
+---
+
+## Backup and archive your data
+Safeguard your data with different backup and archival solutions and discover Scaleway's built-in back up solutions.
+
+<Grid>
+    <SummaryCard
+        title="Create a snapshot of a Block Storage volume"
+        icon="rocket"
+        description="Take snapshots that you can use to recreate volumes."
+        label="Read more"
+        url="/block-storage/how-to/create-a-snapshot/"
+    />
+    <SummaryCard
+        title="How to manage backups for Database Instances"
+        icon="info"
+        description="The autobackup feature allows you to automate backups according to a schedule you define."
+        label="Read more"
+        url="/managed-databases-for-postgresql-and-mysql/how-to/manage-backups/#how-to-set-up-autobackups"
+    />
+</Grid>
+
+## Related tutorials
+
+<UseCaseList category="back-up-data" />

pages/use-cases/best-practices/index.mdx

@@ -0,0 +1,28 @@
+---
+title: Best practices
+description: Learn from Scaleway's expert guides and best practices to optimize your cloud strategy.
+---
+
+## Discover best practices
+Looking to optimize your cloud strategy? Find best practices and guidelines to help you make the most of your cloud resources and services.
+
+<Grid>
+    <SummaryCard
+        title="Getting started with Python"
+        icon="info"
+        description="Python is a free programming language that reads like real English, and is fast and simple to learn the basics. "
+        label="Read more"
+        url="/tutorials/get-started-python/"
+    />
+    <SummaryCard
+        title="First steps with the Linux command line"
+        icon="info"
+        description="Learn how to use a terminal to easily manage use your Scaleway Instances"
+        label="Read more"
+        url="/tutorials/first-steps-linux-command-line/"
+    />
+</Grid>
+
+## Related tutorials
+
+<UseCaseList category="best-practices" />

pages/use-cases/build-and-run-ai/index.mdx

@@ -0,0 +1,28 @@
+---
+title: Build and run AI
+description: Discover how to leverage Scaleway's AI & Data services to develop, train, and deploy powerful AI models.
+---
+
+## Build and run AI at Scaleway
+Scaleway supports AI development and deployment with powerful compute resources and tools. Whether you're training models or deploying AI applications, our services provide the performance and scalability you need.
+
+<Grid>
+    <SummaryCard
+        title="Integrate Generative APIs into n8n workflows"
+        icon="rocket"
+        description="Use n8n's visual interface to integrate Scaleway Generative APIs into your workflows."
+        label="Read more"
+        url="/generative-apis/reference-content/integrate-with-n8n/"
+    />
+    <SummaryCard
+        title="Managed Inference model catalog"
+        icon="info"
+        description="An overview of all inference models available at Scaleway."
+        label="Read more"
+        url="/managed-inference/reference-content/model-catalog/"
+    />
+</Grid>
+
+## Related tutorials
+
+<UseCaseList category="build-and-run-ai" />

pages/use-cases/deploy-external-software/index.mdx

@@ -0,0 +1,28 @@
+---
+title: Deploy and manage external software
+description: Discover how to deploy and manage external software with Scaleway's flexible and customizable cloud environment.
+---
+
+## Deploy and manage external software
+Need to deploy and manage external software on your cloud infrastructure? Scaleway provides the tools and services to help you deploy, manage, and scale external software efficiently.
+
+<Grid>
+    <SummaryCard
+        title="Deploying Chatwoot on Scaleway General Purpose Instances"
+        icon="rocket"
+        description="With Chatwoot, businesses can set up multiple communication channels, integrate them into their websites or applications, and engage with customers in real-time."
+        label="Read more"
+        url="/tutorials/deploy-chatwoot-self-care/"
+    />
+    <SummaryCard
+        title="Creating a Valheim server with Scaleway"
+        icon="info"
+        description="Learn how to create your own Valheim gaming server with Scaleway Instances."
+        label="Read more"
+        url="/tutorials/create-valheim-server/"
+    />
+</Grid>
+
+## Related tutorials
+
+<UseCaseList category="deploy-external-software" />

pages/use-cases/index.mdx

@@ -0,0 +1,86 @@
+---
+title: Use Cases
+description: Discover the different ways you can use the Scaleway products to develop your projects.
+---
+
+## What do you want to do?
+Browse through a wide range of use cases that help you leverage our services for your needs. Whether you're looking to host a website, build AI applications, or secure your resources, our use cases are designed to guide you through the most popular and impactful implementations.
+
+<ClickableBanner
+    productLogo="cli"
+    title="Migrate to Scaleway"
+    url="/use-cases/migration"
+    label="Browse"
+/>
+
+<Grid>
+    <Card
+        title="Host a website"
+        label="Browse"
+        url="/use-cases/website-hosting/"
+    />
+    <Card
+        title="Host a web app"
+        label="Browse"
+        url="/use-cases/application-hosting/"
+    />
+    <Card
+        title="Set up and test"
+        label="Browse"
+        url="/use-cases/set-up-and-test"
+    />
+</Grid>
+
+<Grid>
+    <Card
+        title="Build and run AI"
+        label="Browse"
+        url="/use-cases/build-and-run-ai/"
+    />
+    <Card
+        title="Back up and archive data"
+        label="Browse"
+        url="/use-cases/back-up-data/"
+    />
+    <Card
+        title="Discover best practices"
+        label="Browse"
+        url="/use-cases/best-practices/"
+    />
+</Grid>
+
+<Grid>
+    <Card
+        title="Secure my resources"
+        label="Browse"
+        url="/use-cases/security/"
+    />
+    <Card
+        title="Deploy and manage external software"
+        label="Browse"
+        url="/use-cases/deploy-external-software/"
+    />
+    <Card
+        title="Connect IoT Devices"
+        label="Browse"
+        url="/use-cases/iot"
+    />
+</Grid>
+
+<Grid>
+    <Card
+        title="Manage, share and store data"
+        label="Browse"
+        url="/use-cases/manage-share-and-store-data/"
+    />
+    <Card
+        title="Monitor resources"
+        label="Browse"
+        url="/use-cases/monitoring/"
+    />
+    <Card
+        title="Manage resources"
+        label="Browse"
+        url="/use-cases/resource-management/"
+    />
+</Grid>

pages/use-cases/iot/index.mdx

@@ -0,0 +1,28 @@
+---
+title: Connect IoT devices
+description: Discover how to integrate and manage your IoT ecosystem using Scaleway's IoT Hub.
+---
+
+## Connect IoT devices with Scaleway
+Scaleway supports IoT device connectivity and management. Whether you're building a smart home solution or an industrial IoT system, our services provide the scalability and reliability you need.
+
+<Grid>
+    <SummaryCard
+        title="A quick introduction to the MQTT Protocol"
+        icon="rocket"
+        description="The MQTT protocol, used in Scaleway IoT Hub, allows two remote devices to communicate via messages asynchronously with low bandwidth."
+        label="Read more"
+        url="https://www.scaleway.com/en/blog/introduction-to-mqtt-protocol/"
+    />
+    <SummaryCard
+        title="How to create an IoT Hub route"
+        icon="info"
+        description="IoT Routes interconnect your Hub with services that are not publish/subscribe compatible."
+        label="Read more"
+        url="/iot-hub/how-to/create-route/"
+    />
+</Grid>
+
+## Related tutorials
+
+<UseCaseList category="iot" />

pages/use-cases/manage-share-and-store-data/index.mdx

@@ -0,0 +1,28 @@
+---
+title: Manage, share, store data
+description: Discover the different ways you can use the Scaleway products to develop your projects.
+---
+
+## Manage, share, store data
+Securely store your data on Scaleway's storage solutions and pair them with third-party to automate and simplify data management.
+
+<Grid>
+    <SummaryCard
+        title="Optimize your Object Storage performance"
+        icon="rocket"
+        description="Understand the factors that can impact storage performance, and benefit from best practices to avoid negative impact."
+        label="Read more"
+        url="/object-storage/reference-content/optimize-object-storage-performance/"
+    />
+    <SummaryCard
+        title="Block Storage and Instances bandwidth overview"
+        icon="info"
+        description="An overview of internet and Block Storage bandwidth for Scaleway Instances."
+        label="Read more"
+        url="/use-cases/"
+    />
+</Grid>
+
+## Related tutorials
+
+<UseCaseList category="manage-share-and-store-data" />

pages/use-cases/migration/index.mdx

@@ -0,0 +1,12 @@
+---
+title: Migrate to Scaleway
+description: Discover the different ways you can use the Scaleway products to develop your projects.
+---
+
+## Migrate to Scaleway
+Discover how to seamlessly move your infrastructure to Scaleway.
+
+
+## Related tutorials
+
+<UseCaseList category="migration" />

pages/use-cases/monitoring/index.mdx

@@ -0,0 +1,28 @@
+---
+title: Monitor resources
+description: Discover the different ways you can use the Scaleway products to develop your projects.
+---
+
+## Monitor your resources
+Keep your cloud resources running smoothly with Scaleway and third party monitoring tools. Our services provide real-time insights and alerts to help you maintain optimal performance.
+
+<Grid>
+    <SummaryCard
+        title="How to send metrics and logs to your Cockpit"
+        icon="rocket"
+        description="You can use the Grafana Alloy agent to collect and send metrics, logs, and traces from your applications, services, and infrastructure to Scaleway Cockpit."
+        label="Read more"
+        url="/cockpit/how-to/send-metrics-logs-to-cockpit/"
+    />
+    <SummaryCard
+        title="Audit Trail product integration"
+        icon="info"
+        description="Audit Trail allows you to keep track of the activity of your Scaleway resources. Find out which products are integrated with the feature."
+        label="Read more"
+        url="/use-cases/"
+    />
+</Grid>
+
+## Related tutorials
+
+<UseCaseList category="monitoring" />

pages/use-cases/resource-management/index.mdx

@@ -0,0 +1,28 @@
+---
+title: Manage resources
+description: Discover how to streamline your cloud operations with open-source resource management and orchestration tools.
+---
+
+## Manage your resources
+Simplify your cloud resource management with Scaleway's tools. From provisioning to scaling, our services help you manage your infrastructure efficiently.
+
+<Grid>
+    <SummaryCard
+        title="Set up a Scaleway Terraform configuration file"
+        icon="rocket"
+        description="The Scaleway Terraform configuration file allows you to authenticate, and to determine the default values to use when creating resources with the developer tools."
+        label="Read more"
+        url="/terraform/reference-content/scaleway-configuration-file/"
+    />
+    <SummaryCard
+        title="Terraform/OpenTofu for Scaleway - Quickstart"
+        icon="info"
+        description="Get started with Terraform to manage your Scaleway infrastructure."
+        label="Read more"
+        url="/terraform/quickstart/"
+    />
+</Grid>
+
+## Related tutorials
+
+<UseCaseList category="resource-management" />