rewording

Author: commit111

docs/providers/gcp.md

@@ -7,5 +7,5 @@ sidebar_position: 3000
 # GCP
 
 :::info
-We will be working on GCP support in the future. If you are interested in GCP support, please vote on [this issue](https://github.com/DefangLabs/defang/issues/58).
+GCP support is coming soon to Defang! 
 :::

docs/tutorials/deploy-container-using-the-cli.mdx

@@ -1,9 +1,9 @@
 ---
-title: Deploy pre-built container
+title: Deploy existing container
 sidebar_position: 200
 ---
 
-# Deploy container using the CLI
+# Deploy an Existing Container Using the CLI
 
 This example is useful if you already have a Docker container built manually or through a CI/CD system and have that the resulting image is available in a public or private repository accessible by Defang.
 

docs/tutorials/deploy-to-aws.mdx

@@ -15,22 +15,20 @@ This tutorial will show you how to deploy your services to your own AWS account
 * [The Defang CLI](/docs/getting-started/installing)
 * [AWS Account Credentials](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-authentication.html)
 
-## Deploy your project to AWS
-
-1. Navigate to the directory where your project is located:
+## Step 1 - Navigate to your project directory
+Head to the folder where your project is located.
 ```bash
 $ cd path/to/your/project
 ```
 
-2. Authenticate Defang to use your AWS Account
-
-Defang will look for your AWS credentials in your shell environment.
+## Step 2 - Authenticate Defang to use your AWS Account
 
-Defang will expect to find one of the following credential sets:
+There are many ways to authenticate your [AWS account](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-authentication.html). 
+Once you've done that, Defang will look for your AWS credentials in your shell environment and expect to find one of the following credential sets:
 * the `AWS_PROFILE` environment variable
 * or, the `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` environment variables
 
-3. Deploy
+## Step 3 - Deploy
 
 Invoke the `defang up` CLI command with the `--provider=aws` flag or set the `DEFANG_PROVIDER=aws` environment variable.
 
@@ -40,7 +38,7 @@ For example:
 $ defang up --provider=aws
 ```
 
-4. Inspect your deployment
+## Step 4 - Inspect your deployment
 
 Defang will provision resources in your AWS account and deploy your services. You can inspect the resources created in your AWS dashboard.
 

docs/tutorials/deploy-to-digitalocean.mdx

@@ -16,22 +16,18 @@ This tutorial will show you how to deploy your services to your own Digital Ocea
 * [Digital Ocean Account Credentials](/docs/providers/digitalocean#getting-started)
 * [Digital Ocean Spaces Access Keys](/docs/providers/digitalocean#getting-started)
 
-## Deploy your project to Digital Ocean
-
-1. Navigate to the directory where your project is located:
+## Step 1 - Navigate to your project directory
 ```bash
 $ cd path/to/your/project
 ```
 
-2. Authenticate Defang to use your Digital Ocean Account
-
-Defang will look for your Digital Ocean credentials in your shell environment.
+## Step 2 - Authenticate Defang to use your Digital Ocean Account
 
-Defang will expect to find the following credentials:
+Defang will look for your Digital Ocean credentials in your shell environment and expect to find the following credentials:
 * the `DIGITALOCEAN_TOKEN` environment variable
 * and, the `SPACES_ACCESS_KEY_ID` and `SPACES_SECRET_ACCESS_KEY` environment variables
 
-3. Deploy
+## Step 3 - Deploy
 
 Invoke the `defang up` CLI command with the `--provider=do` flag or set the `DEFANG_PROVIDER=do` environment variable.
 
@@ -41,7 +37,7 @@ For example:
 $ defang up --provider=do
 ```
 
-4. Inspect your deployment
+## Step 4 - Inspect your deployment
 
 Defang will provision resources in your Digital Ocean account and deploy your services. You can inspect the resources created in your Digital Ocean dashboard.
 

docs/tutorials/deploy-to-gcp.mdx

@@ -7,3 +7,8 @@ sidebar_position: 10
 # Deploying to Google Cloud Platform (GCP) with Defang
 
 Coming soon!
+
+---
+
+For a deeper discussion of the Defang GCP Architecture, see our [GCP docs](/docs/providers/gcp).
+

docs/tutorials/deploy-to-your-cloud.mdx

@@ -4,14 +4,14 @@ description: Defang allows you deploy to your own cloud account.
 sidebar_position: 10
 ---
 
-# Deploying to your cloud with Defang
+# Deploying to Your Cloud With Defang
 
 This tutorial will show you how to deploy your services to your own cloud account using Defang.
 
-::: tip
-::: Defang makes it easier to deploy to any cloud—in your *own* cloud accounts. We refer to this as bring-your-own-cloud (BYOC).
+:::tip
+Defang makes it easier to deploy to any cloud—in your *own* cloud accounts. We refer to this as bring-your-own-cloud (BYOC).
+If you aren't ready to deploy to your own cloud account, you can use the Defang Playground to get a feel for how Defang works for free.
 :::
-::: If you aren't ready to deploy to your own cloud account, you can use the Defang Playground to get a feel for how Defang works for free.
 
 ## Choose your cloud
 

docs/tutorials/generate-new-code-using-ai.mdx

@@ -3,7 +3,7 @@ title: Deploy an outline using AI
 sidebar_position: 50
 ---
 
-# Deploy an outline using AI
+# Deploy an Outline of a Project Using AI
 
 Defang supports generating new project outlines using integration with an AI model. Using this feature, you can describe what you would like the service to do and the CLI will then generate a project outline with all the files required to make it work.
 <iframe width="560" height="315" src="https://www.youtube.com/embed/afglsBYieuc?si=GCvHhBu3H9ktMDHA" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>