Merge branch 'main' into linda-dashboard

Author: commit111

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-12-04-launch-week.md

@@ -33,7 +33,7 @@ At **Defang**, we’re enabling developers go from **idea to code to deployment
 
 - **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

@@ -14,7 +14,7 @@ You can find a sample of how to set environment variables with Pulumi [here](htt
 
 # 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

docs/concepts/managed-storage/managed-postgres.md

@@ -22,7 +22,7 @@ To use managed Postgres, in your `compose.yaml` file, use the `x-defang-postgres
 
 ### Required Configuration
 
-When using managed Postgres, you **must** set a password for the database using `defang config set POSTGRES_PASSWORD`. If you do not provide the password, the deployment will fail. 
+When using managed Postgres, you **must** set a password for the database using `defang config set POSTGRES_PASSWORD`. If you do not provide the password, the deployment will fail.
 
 - `POSTGRES_PASSWORD`: You can can assign the password in the service's environment variables. To learn more about how this works, read about [configuration](../configuration.md).
 
@@ -38,7 +38,7 @@ You can also set the following optional environment variables to configure the m
 You can connect to the managed Postgres instance using the name of your service as the hostname, `POSTGRES_USER`, `POSTGRES_DB`, and `POSTGRES_PASSWORD` environment variables.
 
 ### Example
-:::info 
+:::info
 For a smoother experience with Defang, we recommend using Postgres 14 for your container images. This version provides easier access and improved usability.
 :::
 
@@ -85,7 +85,7 @@ The AWS Console can be used to restore a snapshop into a new instance of postgre
 <!-- 
 ### Major Version Updating of Engine
 
-To update the database engine you can simply update the image to a later version in your Compose file and apply it via ```defang compose up --provider=aws```. In the example below, we change from Postgres 15 to 16.
+To update the database engine you can update the image to a later version in your Compose file and apply it via ```defang compose up --provider=aws```. In the example below, we change from Postgres 15 to 16.
 
 Please note the upgrading will occur immediately and may result in the database being unavailable for some time.
 

docs/providers/aws/aws.md

@@ -52,6 +52,10 @@ To deploy your services, the Defang CLI packages your code and uploads it to an
 
 The provider runs your workloads using ECS using Fargate. It provisions a VPC with public and private subnets, and deploys your services to the private subnets. It then provisions an Application Load Balancer (ALB) and routes traffic to your services.
 
+### Service Discovery
+
+Defang uses a Route53 private hosted zone for service discovery. Each (private) service in the Compose file will get a CNAME or A record which resolves to the service's AWS domain name or IP, respectively. To update the A records for the dynamically assigned IP addresses, Defang will add a [Route53 sidecar](https://github.com/DefangLabs/route53-sidecar) alongside your container.
+
 ## Managed Storage
 
 Defang can help you provision [managed storage](/docs/concepts/managed-storage/managed-storage.md) services. The following managed storage services are supported on AWS:

docs/providers/digitalocean/digitalocean.md

@@ -39,8 +39,7 @@ The Defang CLI will automatically check if these envinonment variables are set b
 
 ### Deploy your project to DigitalOcean
 
-Once you are ready to go, add the `--provider=digitalocean` to your command to tell the Defang CLI to use the DigitalOcean provider.
-
+Once you are ready to go, add the `--provider=digitalocean` to your command to tell the Defang CLI to use the DigitalOcean provider or set the `DEFANG_PROVIDER` environment variable to `digitalocean`.
 ```bash
 $ defang compose up --provider=digitalocean
 # or

docs/providers/gcp.md

@@ -27,12 +27,12 @@ gcloud init
 gcloud auth application-default login
 ```
 
-The Defang CLI will automatically check if `GCP_PROJECT_ID` environment variable is set and correctly authenticated with GCP before running. Once you are ready to go, add the `--provider=gcp` to your command to tell the Defang CLI to use the GCP provider.
+The Defang CLI will automatically check if `GCP_PROJECT_ID` environment variable is set and correctly authenticated with GCP before running. Once you are ready to go, add the `--provider=gcp` flag to your command to tell the Defang CLI to use the GCP provider, or set the `DEFANG_PROVIDER` environment variable to `gcp`.
 
 ```bash
-$ defang up --provider=gcp
+$ defang compose up --provider=gcp
 # or
-$ DEFANG_PROVIDER=gcp defang up
+$ export DEFANG_PROVIDER=gcp
 ```
 
 ## Location

docs/tutorials/deploy-to-gcp.mdx

@@ -27,12 +27,12 @@ After signing in to your GCP account, select an existing project or [create a ne
 
 ## Step 3 - Deploy
 
-Invoke the `defang up` CLI command with the `--provider=gcp` flag or set the `DEFANG_PROVIDER=gcp` environment variable.
+Invoke the `defang compose up` CLI command with the `--provider=gcp` flag or set the `DEFANG_PROVIDER=gcp` environment variable.
 
 For example:
 
 ```bash
-$ defang up --provider=gcp
+$ defang compose up --provider=gcp
 ```
 
 ## Step 4 - Inspect your deployment