add a section about debugging

Author: raphaeltm

docs/concepts/debug.md

@@ -0,0 +1,13 @@
+---
+title: Debug
+description: Defang uses AI to help you debug your cloud applications.
+sidebar_position: 650
+---
+
+# Debug
+
+Defang includes an AI-driven tool to help you debug your cloud applications. The AI assistant will use your service logs as well as the files in your project to help you identify and resolve issues.
+
+:::warning
+The AI debugging assistant is currently in beta and is currently limited in its capabilities. We plan to expand the capabilities of the AI assistant in the future.
+:::

docs/concepts/ai.md renamed to docs/concepts/generate.md

@@ -1,16 +1,15 @@
 ---
-title: AI
-description: How Defang uses AI to help you build and deploy your cloud applications.
+title: Generate
+description: Defang uses AI to help you generate a starting point for your cloud applications.
 sidebar_position: 100
 ---
 
-# AI
-
+# Generate
 
 Defang includes an AI-driven assistant that translates natural language prompts to an outline for your project that you can then refine. The AI assistant is available through the [Defang CLI](../getting-started/installing.md).
 
 :::info
-The AI assistant is currently in beta and only supports a limited set of prompts. We plan to expand the capabilities of the AI assistant in the future.
+The AI assistant is currently in beta and only supports a limited set of prompts, varying in complexity. We plan to expand the capabilities of the AI assistant in the future.
 :::
 
 We are working on expanding the range of supported prompts and improving the accuracy of the AI assistant. If you have any feedback or suggestions, please let us know by [opening an issue](https://github.com/DefangLabs/defang/issues/new).
@@ -38,3 +37,9 @@ A simple next.js app that serves a static page
 ```
 A simple api with a single route built on express
 ```
+
+**An example of a more complex prompt**
+
+```
+A service that uses bullmq and redis. The compose file should also include a redis service. The code should setup a queue. It should also expose three endpoints with express: one to add a job to the queue, another to check how many tasks are in the queue, and a last one that runs on / which is just a healthcheck. The code should also include a worker that processes the queue by logging what's in each task. Use environment variables to configure the redis connection. No password.
+```

docs/intro.md

@@ -21,7 +21,8 @@ Defang provides a streamlined experience to develop, deploy, observe, and update
 
 - Support for [various types of applications](./use-cases/use-cases.md): Web services and APIs, mobile app backends, ML services, hosting LLMs, etc.
 - Support for your programming [language of choice](./samples.md): Node.js, Python, Golang, or anything else you can package in a Dockerfile.
-- Built-in [AI assistant](./concepts/ai.md) to go from natural language prompt to an outline project
+- Built-in AI assistant to go [from natural language prompt to an outline project](./concepts/generate.md)
+- Built-in AI assistant to help you [debug your cloud applications](./concepts/debug.md)
 - Automated [Dockerfile builds](./concepts/deployments.md)
 - Support for [pre-built Docker containers](./tutorials/deploy-container-using-the-cli.mdx), from public or private image registries
 - Ability to express your project configuration using a [Docker Compose YAML](./concepts/compose.md) file