Upload rendered site to object storage, 3

.github/workflows/build-production-site.yaml

@@ -51,12 +51,12 @@ on:
 #         └── linode_algolia_admin
 
 jobs:
-  deploy-to-production:
+  build-production-site:
     if: github.repository_owner == 'linode'
     runs-on: ubuntu-latest
 
     environment:
-      name: deploy_to_production
+      name: build_production_site
       url: ${{ vars.DOCS_WEBSITE_URL }}
 
     steps:
@@ -208,7 +208,8 @@ jobs:
         hugo config
         hugo -b "${{ vars.DOCS_WEBSITE_URL }}" --gc --minify -d public
 
-      # The gitcommithash.txt file is used in the last workflow step to verify that the deployment was successful
+      # The gitcommithash.txt file is used when the site is deployed to the
+      # webserver to verify that the deployment was successful.
     - name: 13. Add gitcommithash.txt to rendered public/ folder
       working-directory: ./docs-repo
       run: |

.github/workflows/build-staging-site.yaml

@@ -50,12 +50,12 @@ on:
 #         └── linode_algolia_admin
 
 jobs:
-  deploy-to-main-staging-server:
+  build-staging-site:
     if: github.repository_owner == 'linode'
     runs-on: ubuntu-latest
 
     environment:
-      name: deploy_to_main_staging_server
+      name: build_staging_site
 
     steps:
     - name: 1. Set up Hugo
@@ -212,7 +212,8 @@ jobs:
         hugo config
         hugo -b "${{ secrets.DOCS_WEBSITE_URL }}" --gc --minify -d public
 
-      # The gitcommithash.txt file is used in the last workflow step to verify that the deployment was successful
+      # The gitcommithash.txt file is used when the site is deployed to the
+      # webserver to verify that the deployment was successful.
     - name: 13. Add gitcommithash.txt to rendered public/ folder
       working-directory: ./docs-repo
       run: |

.github/workflows/build-testing-site.yaml

@@ -51,12 +51,12 @@ on:
 #         └── linode_algolia_admin
 
 jobs:
-  deploy-to-feature-testing-server:
+  build-testing-site:
     if: github.repository_owner == 'linode'
     runs-on: ubuntu-latest
 
     environment:
-      name: deploy_to_feature_testing_server
+      name: build_testing_site
 
     steps:
     - name: 1. Set up Hugo
@@ -213,7 +213,8 @@ jobs:
         hugo config
         hugo -b "${{ secrets.DOCS_WEBSITE_URL }}" --gc --minify -d public
 
-      # The gitcommithash.txt file is used in the last workflow step to verify that the deployment was successful
+      # The gitcommithash.txt file is used when the site is deployed to the
+      # webserver to verify that the deployment was successful.
     - name: 13. Add gitcommithash.txt to rendered public/ folder
       working-directory: ./docs-repo
       run: |