ci: Restructure pipeline

Author: aiakide

.github/workflows/main.yml

@@ -1,37 +1,32 @@
-# This is a basic workflow to help you get started with Actions
+#This GitHub Workflow builds the necessary docker images for the `from jupyter to production workshop`
+name: Build and publish workshop Docker images 🔨🐳🚀
 
-name: CI
-
-# Controls when the action will run. 
 on:
-  # Triggers the workflow on push or pull request events but only for the master branch
+  # Triggers the workflow when a new tag with the pattern 'v*.*.*' is pushed to the repository
   push:
     tags:
       - 'v*.*.*'
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
-# A workflow run is made up of one or more jobs that can run sequentially or in parallel
 jobs:
-  # This workflow contains a single job called "build"
+  # This job creates and publishes the mlflow docker images
   build-mlflow:
-    # The type of runner that the job will run on
     runs-on: ubuntu-latest
-
-    # Steps represent a sequence of tasks that will be executed as part of the job
     steps:
       - name: Checkout Repo ✅
         uses: actions/checkout@v2
 
-      - uses: ./.github/actions/shared-build-steps
+      - name: Job preparation 🛫 # Steps that must be carried out before creating the Docker images
+        uses: ./.github/actions/shared-build-steps
         with:
           dockerhub_user: ${{ secrets.DOCKERHUB_USER }}
           dockerhub_password: ${{ secrets.DOCKERHUB_PASSWORD }}
           runner_os: ${{ runner.os }}
           github_sha: ${{ github.sha }}
 
-      - name: Docker meta 💬
+      - name: Docker meta 💬 # Creating meta information such as the image tag for the Docker image
         id: meta
         uses: docker/metadata-action@v5
         with:
@@ -52,23 +47,23 @@ jobs:
 
       - name: Image digest
         run: echo ${{ steps.docker_build.outputs.digest }}
+
+  # This job creates and publishes the jupyter docker images
   build-jupyter:
-    # The type of runner that the job will run on
     runs-on: ubuntu-latest
-
-    # Steps represent a sequence of tasks that will be executed as part of the job
     steps:
       - name: Checkout Repo ✅
         uses: actions/checkout@v2
 
-      - uses: ./.github/actions/shared-build-steps
+      - name: Job preparation 🛫 # Steps that must be carried out before creating the Docker images
+        uses: ./.github/actions/shared-build-steps
         with:
           dockerhub_user: ${{ secrets.DOCKERHUB_USER }}
           dockerhub_password: ${{ secrets.DOCKERHUB_PASSWORD }}
           runner_os: ${{ runner.os }}
           github_sha: ${{ github.sha }}
 
-      - name: Docker meta 💬
+      - name: Docker meta 💬 # Creating meta information such as the image tag for the Docker image
         id: meta
         uses: docker/metadata-action@v5
         with: