diff --git a/.github/workflows/build-docker.yml b/.github/workflows/build-docker.yml
index f12b2f68..daf33929 100644
--- a/.github/workflows/build-docker.yml
+++ b/.github/workflows/build-docker.yml
@@ -1,5 +1,7 @@
-name: Create and publish a Docker image
+name: Build and push a Docker image to GHCR
 
+# Trigger the workflow on push events, ignoring changes to README.md
+# and only for the 'master' and 'guest_accounts' branches
 on:
   push:
     paths-ignore:
@@ -8,6 +10,7 @@ on:
       - master
       - guest_accounts
 
+# Set environment variables for the registry and image name
 env:
   REGISTRY: ghcr.io
   IMAGE_NAME: ${{ github.repository }}
@@ -15,28 +18,34 @@ env:
 jobs:
   build-and-push-image:
     runs-on: ubuntu-latest
+    # Set permissions for reading the repository contents and writing packages
     permissions:
       contents: read
       packages: write
 
+    # Define a matrix to build the image for multiple platforms
     strategy:
       matrix:
         platform: [linux/amd64, linux/arm64]
 
     steps:
+      # Checkout the repository code
       - name: Checkout repository
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
+      # Set up QEMU for multi-platform builds
       - name: Set up QEMU
         uses: docker/setup-qemu-action@v3
 
+      # Set up Docker Buildx for multi-platform builds
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
         with:
           version: latest
 
+      # Login to GitHub Container Registry (GHCR)
       - name: Login to GHCR
         uses: docker/login-action@v3
         with:
@@ -44,12 +53,14 @@ jobs:
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
+      # Extract metadata (tags and labels) for the Docker image
       - name: Extract metadata (tags, labels) for Docker
         id: meta
         uses: docker/metadata-action@v5
         with:
           images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
 
+      # Build and push the Docker image to GHCR
       - name: Build and push Docker image
         uses: docker/build-push-action@v5
         with: