merged

Author: raphaeltm

blog/2023-06-29-Announcing-the-Private-Beta-for-the-DOP.md

@@ -12,7 +12,7 @@ We realize that improving on this state of affairs is a long journey. Today, we
 
 **Try the Private Beta!**
 
-To try the Private Beta, please go to [portal.defang.dev](https://portal.defang.dev) and register. We would love to have you kick the tires and give us your feedback! You can also check out our [documentation](https://docs.defang.io/docs/intro), [samples](https://docs.defang.io/docs/intro), and our [Github repository](https://github.com/DefangLabs).
+To try the Private Beta, please go to [portal.defang.dev](https://portal.defang.dev) and register. We would love to have you kick the tires and give us your feedback! You can also check out our [documentation](https://docs.defang.io/docs/intro), [samples](https://docs.defang.io/docs/intro), and our [GitHub repository](https://github.com/DefangLabs).
 
 **Stay Tuned for More**
 

blog/2024-02-12-announcing-defang-public-beta.md

@@ -16,7 +16,7 @@ You can learn more about Defang [here](https://docs.defang.io/docs/intro). Also
 
 **Try the Public Beta!**
 
-To try the Public Beta, please go to [defang.io](http://defang.io) and click on [Download](https://github.com/DefangLabs/defang/releases/latest) to download the CLI and [get started](https://docs.defang.io/docs/getting-started). We would love to have you kick the tires and give us your feedback! Once you sign up you’ll receive an invitation to our Slack support channel in email. You are also welcome to file [Github issues here](https://github.com/DefangLabs/defang/issues).
+To try the Public Beta, please go to [defang.io](http://defang.io) and click on [Download](https://github.com/DefangLabs/defang/releases/latest) to download the CLI and [get started](https://docs.defang.io/docs/getting-started). We would love to have you kick the tires and give us your feedback! Once you sign up you’ll receive an invitation to our Slack support channel in email. You are also welcome to file [GitHub issues here](https://github.com/DefangLabs/defang/issues).
 
 **Stay Tuned for More**
 

blog/2024-03-20-dev-environments.mdx

@@ -15,12 +15,12 @@ We want it to be easy for you to try Defang with as little friction as possible,
 
 ## Codespaces
 
-If you want to get started with Codespaces, you can just fork [this repo](https://github.com/DefangLabs/github-codespace). It comes with the Defang CLI pre-installed so you can start playing with it immediately. It's setup using the Defang CLI [Dev Container Feature](https://github.com/DefangLabs/devcontainer-feature/pkgs/container/devcontainer-feature%2Fdefang-cli).
+If you want to get started with Codespaces, you can just fork [this repo](https://github.com/DefangLabs/github-codespace). It comes with the Defang CLI pre-installed so you can start playing with it immediately. It's set up using the Defang CLI [Dev Container Feature](https://github.com/DefangLabs/devcontainer-feature/pkgs/container/devcontainer-feature%2Fdefang-cli).
 
 ## Dev Containers
 
 [Dev Containers](https://code.visualstudio.com/docs/devcontainers/containers) are a cool way to provision and configure development environments and share that configuration with other people you are working with. It's a spec that is supported by [VS Code](https://code.visualstudio.com/docs/devcontainers/containers), [Visual Studio](https://devblogs.microsoft.com/cppblog/dev-containers-for-c-in-visual-studio/), the JetBrains IDEs like [IntelliJ](https://www.jetbrains.com/help/idea/connect-to-devcontainer.html) and [PyCharm](https://www.jetbrains.com/help/pycharm/connect-to-devcontainer.html), [DevPod](https://devpod.sh/docs/developing-in-workspaces/devcontainer-json) and others.
 
-## GitPod
+## Gitpod
 
-GitPod is another Cloud IDE, a bit like GitHub Codespaces. If prefer GitPod, you can try Defang in a GitPod environment by using [this repo](https://github.com/DefangLabs/gitpod-workspace/tree/main).
+Gitpod is another Cloud IDE, a bit like GitHub Codespaces. If prefer Gitpod, you can try Defang in a Gitpod environment by using [this repo](https://github.com/DefangLabs/gitpod-workspace/tree/main).

blog/2024-03-28-slackbot-sample.md

@@ -47,7 +47,7 @@ Now that we have everything set up, let's dive into the deployment process. Foll
 2.  **Deploy the Slackbot:**  Use the Defang CLI's `defang compose up` command to deploy.
 
 ## Usage
-With your Slackbot up and running, let's explore how to make the most of it. Simply send a POST request to the `/` endpoint with a JSON body containing the message you want to post to the Slack channel. Popular tools like cURL or Postman can help you send the request:
+With your Slackbot up and running, let's explore how to make the most of it. Let's send a POST request to the `/` endpoint with a JSON body containing the message you want to post to the Slack channel. Popular tools like cURL or Postman can help you send the request:
 
 ```bash
 curl 'https://raphaeltm-bot--8080.prod1.defang.dev/' \

blog/2024-05-01-may-product-updates.md

@@ -11,7 +11,7 @@ Hey folks! There is a lot going on at Defang and we're excited to share our late
 
 ## npx defang
 
-We know a lot of you are using Defang for the first time. To make it easier to get started, we've added a new way to install the Defang CLI. Now you can use npx to run the CLI without installing it globally. Just run:
+We know a lot of you are using Defang for the first time. To make it easier to get started, we've added a new way to install the Defang CLI. Now you can use npx to run the CLI without installing it globally by running:
 
 ```bash
 npx defang@latest

blog/2024-11-12-hard-lessons-from-hardware.md

@@ -41,7 +41,7 @@ This is what the Flask server looked like on my computer as it got pinged:
 
 Hooray! Once everything was working, It was time to deploy my Flask code as a cloud service so I could access it from any computer, not just my own. Deployment usually takes several hours due to configuring a ton of cloud provider settings. But I ain’t got time for that. Instead, I used Defang to deploy it within minutes, which took care of all that for me. Saved me a lot of time and tears.
 
-Here’s the Flask deployment on Defang’s portal view: 
+Here’s the Flask deployment on Defang’s Portal view: 
 
 ![portal_view](/img/hardware-story/portal_view.png)
 

blog/2024-12-04-launch-week.md

@@ -27,13 +27,13 @@ import { Button } from '@mui/material';
 
 At **Defang**, we’re enabling developers go from **idea to code to deployment 10x faster**.  We’re thrilled to announce that **Defang V1** is officially launching during our action-packed **Launch Week**, running from **December 4–10, 2024**! This marks a major milestone as we officially release the tools and features developers have been waiting for.
 
-## **What’s New in V1?**
+## **What’s New in Defang CLI V1?**
 
 **Defang is a powerful tool that lets you easily develop, deploy, and debug production-ready cloud applications**. With Defang V1, we continue to deliver on our vision to make **cloud development effortlessly simple and portable, with the ability to develop once and deploy anywhere**. Here’s what’s included in this milestone release:
 
 - **Production-Ready Support for AWS**
 
-Seamlessly deploy and scale with confidence on [AWS](https://docs.defang.io/docs/providers/aws). Defang is now [WAFR](https://aws.amazon.com/premiumsupport/business-support-well-architected/)-compliant, assuring that your deployments confirm to all the best-practices for AWS deployments. Defang is now officially part of the [AWS Partner Network](https://aws.amazon.com/partners/). 
+Seamlessly deploy and scale with confidence on [AWS](https://docs.defang.io/docs/providers/aws). Defang is now [WAFR](https://aws.amazon.com/premiumsupport/business-support-well-architected/)-compliant, assuring that your deployments conform to all the best-practices for AWS deployments. Defang is now officially part of the [AWS Partner Network](https://aws.amazon.com/partners/). 
 
 - **New - Google Cloud Platform ([GCP](https://docs.defang.io/docs/providers/gcp)) in Preview**
 
@@ -51,7 +51,7 @@ As we move into V1, we are also rolling out our differentiated product tiers, al
 
 We’ve lined up an exciting week of activities to showcase the power of **Defang** and bring together our growing community:
 
-- **December 4: Vancouver CDW x AWS re:Invent WatchParty**
+- **December 4: Vancouver CDW x AWS re:Invent Watch Party**
 
 Join us at the Vancouver [CDW x AWS re:Invent Watch Party](https://lu.ma/1r0zsw76), where we will have a booth showcasing Defang’s capabilities and AWS integration. Stop by to learn more about Defang and see a live demo from the Defang dev team. 
 

docs/concepts/accounts.md

@@ -16,7 +16,7 @@ Eventually, billing and payment information will be associated with your account
 
 ## Creating an Account
 
-To create an account, simply login to Defang and accept the [terms of service](https://defang.io/terms-service.html) using the [CLI](/docs/concepts/authentication.md).
+To create an account, login to Defang and accept the [terms of service](https://defang.io/terms-service.html) using the [CLI](/docs/concepts/authentication.md).
 
 At the moment, the only way to authenticate with Defang is through GitHub. We plan to offer other authentication providers in the future.
 

docs/concepts/configuration.md

@@ -6,15 +6,11 @@ sidebar_position: 225
 
 # Configuration
 
-Defang allows you to configure your application using environment variables. You can set environment variables in your [`compose.yaml` file](./compose.md), or in your [Pulumi program](./pulumi.md). Using Pulumi gives you the advantage of being able to manage your environment variables across different environments using Pulumi stacks.
+Defang allows you to configure your application using environment variables. You can set environment variables in your [`compose.yaml` file](./compose.md), or in your [Pulumi program](#using-config-with-pulumi).
 
-:::tip Sample
-You can find a sample of how to set environment variables with Pulumi [here](https://github.com/DefangLabs/defang/tree/main/samples/nodejs/remix-aiven-postgres).
-:::
-
-# Sensitive Config aka Secrets
+# Sensitive Config (aka Secrets)
 
-The Defang CLI allows you to securely store sensitive information such as API keys, passwords, and other credentials. To do so just run:
+The Defang CLI allows you to securely store sensitive information such as API keys, passwords, and other credentials. To do so, run:
 
 ```bash
 # Set a configuration value called API_KEY
@@ -44,6 +40,10 @@ services:
 
 Use the `defang config` command of the Defang CLI to manage the values.
 
+:::tip
+You can find a sample of how to set sensitive config values [here](https://github.com/DefangLabs/samples/tree/main/samples/nodejs-openai).
+:::
+
 ## Interpolation
 
 Environment variables are set within the *environment* section of a service in a `compose.yaml` file. Any variables declared here will become available within the service container.
@@ -62,18 +62,24 @@ In the example above, if we assume the value of the configuration variable ***US
 
 During `defang compose up` all variable references will be replaced with the actual value and made available in the container. If any referenced variable is not found the `defang compose up` command will be canceled.
 
+## Using Config with Pulumi 
+In Defang, using config with [Pulumi](./pulumi.md) gives you the advantage of being able to manage your environment variables across different environments using Pulumi stacks.
+
+:::tip
+You can find a sample of how to set environment variables with Pulumi [here](https://github.com/DefangLabs/samples/tree/main/samples/pulumi-remix-postgres).
+:::
+
 ## Connecting Services
 
 If you have created a service before a secret you can connect it by running the `defang compose start` command if using the [`defang compose` workflow](./compose.md). If you are using the [Pulumi-based workflow](./pulumi.md) you will need to redeploy using Pulumi.
 
-:::tip Sample
-You can find a sample of how to set sensitive config values [here](https://github.com/DefangLabs/defang/tree/main/samples/nodejs/ChatGPT%20API).
-:::
-
 ## Providers
 
 Here are the different ways sensitive config values are stored depending on the provider you are using:
 
     * [AWS](../providers/aws/aws.md#secrets)
+    * [DigitalOcean](../providers/digitalocean#secrets)
+    * [GCP](../providers/gcp#secrets)
+
 
 

docs/concepts/debug.md

@@ -6,16 +6,30 @@ sidebar_position: 650
 
 # Debug
 
-Defang includes an AI-driven tool to help you debug your cloud applications. The AI agent will use your service logs as well as the files in your project to help you identify and resolve issues.
+Defang includes an AI-driven tool in the CLI (command-line interface) to help you debug your cloud applications. The AI agent will use your service logs as well as the files in your project to help you identify and resolve issues.
 
-:::warning
-The AI debugging agent is currently in preview and is currently limited in its capabilities. We plan to expand the capabilities of the AI agent in the future.
+:::info
+Defang has another AI-driven tool called [`generate`](/docs/concepts/generate).
 :::
 
-## How it works
+## How It Works
+
+Here is a typical workflow in the [Defang CLI](/docs/getting-started) that will automatically run the AI debugger tool:
+
+1. When you deploy a project with Defang (i.e. `defang compose up`), the CLI will wait for all services' statuses to switch to healthy. 
+
+2. If any service fails to deploy, the AI debugger will kick in and ask for permission.
+
+3. The AI agent will analyze the logs and files in your project to identify the issue(s).
+
+4. Then, it will provide you with the suggested fix(es) in the terminal. 
+
+:::tip
+The AI debugger will not change your files. Instead, it will show you a suggestion, and it is up to you if you want to use it in your code.
+:::
 
-When you deploy a project with Defang, the CLI will wait for all services' statuses to switch to healthy. If any service fails to deploy, the AI debugger will kick in. It will analyze the logs and files in your project to identify the issue and provide you with a suggested fix. **The AI debugger will not change your files.**
+The AI debugger only kicks in when any service in a project fails to deploy. This could be because of a build failure, healthchecks failing, or a variety of other issues. 
 
 :::info
-The AI debugger only kicks in when any service in a project fails to deploy. This could be because of a build failure, healthchecks failing, or a variety of other issues. At the moment, we do not offer any way to trigger the AI debugger manually.
+The AI debugger only kicks in when any service in a project fails to deploy. At the moment, we do not offer any way to trigger the AI debugger manually. 
 :::