docs: update deploy pages's subtitles to make it clear and consistent (#1237)

Co-authored-by: Jochum van der Ploeg <[email protected]>
Co-authored-by: Alejandro Santiago <[email protected]>

Author: 3 people

docs/docs/deploy/aws-app-runner.md

@@ -52,15 +52,19 @@ aws ecr create-repository --repository-name [REPOSITORY_NAME]
 
 ## Deploying
 
-1. Build your API for production use by running:
+### 1. Build your API for production use
+
+Simply run:
 
 ```bash
 dart_frog build
 ```
 
 This will create a /build directory with all the files needed to deploy your API.
 
-2. Build your API using Docker by running:
+### 2. Build your API using Docker
+
+In order to build a Docker image, you can run this command:
 
 ```bash
 docker build build \
@@ -72,19 +76,25 @@ docker build build \
 - `[REPOSITORY_NAME]`: The name of the repository you created earlier
 - `[IMAGE_TAG]`: A name given to this image to identify it in the repository
 
-This command will build the Docker image on your computer and can take a few seconds to a few minutes.
+It will build the Docker image on your computer, this can take a few seconds to a few minutes.
+
+### 3. Push the image to ECR
 
-3. Push the image to ECR by running:
+Now that you have the image on your computer, you can push it to ECR:
 
 ```bash
 docker push [AWS_ACCOUNT_ID].dkr.ecr.[REGION].amazonaws.com/[REPOSITORY_NAME]:[IMAGE_TAG]
 ```
 
 You should now see your repository in the [ECR console](https://console.aws.amazon.com/ecr)
 
-4. Create your App Runner service following [these instructions](https://docs.aws.amazon.com/apprunner/latest/dg/manage-create.html#:~:text=Create%20a%20service%20from%20an%20Amazon%20ECR%20image). Look for the `Create a service from an Amazon ECR image` section.
+### 4. Create your App Runner Service
+
+Follow [these instructions](https://docs.aws.amazon.com/apprunner/latest/dg/manage-create.html#:~:text=Create%20a%20service%20from%20an%20Amazon%20ECR%20image). Look for the `Create a service from an Amazon ECR image` section.
+
+### 5. Enjoy your API on AWS!
 
-5. Congratulations! 🎉 You have successfully built and deployed your API to App Runner. You can now access your API at the Default domain on the [App Runner console](https://console.aws.amazon.com/apprunner)
+Congratulations 🎉, you have successfully built and deployed your API to App Runner. You can now access your API at the Default domain on the [App Runner console](https://console.aws.amazon.com/apprunner)
 
 ## Additional Resources
 

docs/docs/deploy/digital-ocean-app-platform.md

@@ -65,15 +65,19 @@ Be creative - registry names must be unique across all Digital Ocean container r
 
 ## Deploying
 
-1. Build your API for production use by running:
+### 1. Build your API for production use
+
+Simply run:
 
 ```bash
 dart_frog build
 ```
 
 This will create a `/build` directory with all the files needed to deploy your API.
 
-2. Build your API using Docker by running:
+### 2. Build your API using Docker
+
+In order to build a Docker image, you can run this command:
 
 ```bash
 docker build build \
@@ -95,17 +99,21 @@ For example, if you build on an M1 CPU, the generated image will not be able to
 We recommend using an automated workflow via GitHub Actions to automate deployments and ensure a consistent environment when building your image.
 :::
 
-3. Push the image to Container Registry by running:
+### 3. Push the image to Container Registry
 
 ```bash
 docker push registry.digitalocean.com/[REGISTRY]/[IMAGE_NAME]
 ```
 
 You should now see your repository in the [Container Registry page](https://cloud.digitalocean.com/registry)
 
-4. Create your App by following [these instructions](https://docs.digitalocean.com/products/app-platform/how-to/deploy-from-container-images/#deploy-resource-using-a-container-image-as-the-source).
+### 4. Create your App
+
+Create an application on Digital Ocean by following [these instructions](https://docs.digitalocean.com/products/app-platform/how-to/deploy-from-container-images/#deploy-resource-using-a-container-image-as-the-source).
+
+### 5. Enjoy your API on Digital Ocean!
 
-5. Congratulations! You have successfully built and deployed your API to App Platform. You can now access your API via the URL at the top of the app’s overview page 🎉
+Congratulations 🎉, you have successfully built and deployed your API to App Platform. You can now access your API via the URL at the top of the app’s overview page 🎉
 
 ## Additional Resources
 

docs/docs/deploy/globe.md

@@ -25,13 +25,17 @@ globe login
 
 ## Deploying
 
-1. Deploy your API for production use by running:
+### 1. Deploy your API for production
+
+In order to deploy, you can simply run:
 
 ```bash
 globe deploy --prod
 ```
 
-2. Congratulations! 🎉 You have successfully deployed your API to Globe. You can now access your API at the Deployment URL that is available through the Globe dashboard.
+### 2. Enjoy your API on Globe!
+
+Congratulations 🎉, you have successfully built and deployed your API on Globe. You can now access your API at the Deployment URL that is available through the Globe dashboard.
 
 ## Additional Resources
 

docs/docs/deploy/google-cloud-run.md

@@ -33,15 +33,19 @@ gcloud auth login
 
 ## Deploying
 
-1. Build your API for production use by running:
+### 1. Build your API for production use
+
+Simply run:
 
 ```bash
 dart_frog build
 ```
 
 This will create a `/build` directory with all the files needed to deploy your API.
 
-2. Deploy your API to Cloud Run by running:
+### 2. Deploy your API to Cloud Run
+
+In order to deploy to Cloud Run, you can run the following command:
 
 ```bash
 gcloud run deploy [SERVICE_NAME] \
@@ -65,7 +69,9 @@ Running this command will do three things:
 - Build the Docker image in [Cloud Build](https://cloud.google.com/build) and upload it to [Artifact Registry](https://cloud.google.com/artifact-registry)
 - Deploy the image to the specified Cloud Run service
 
-3. Congratulations! 🎉 You have successfully built and deployed your API to Cloud Run. You can now access your API at the Service URL that is printed in the last line of output.
+### 3. Enjoy your API on Cloud Run!
+
+Congratulations 🎉, you have successfully built and deployed your API to Cloud Run. You can now access your API at the Service URL that is printed in the last line of output.
 
 :::note
 If you have not already enabled the necessary Google Cloud APIs to deploy your API, `gcloud` can enable them for you. Just select `Y` when prompted.