rename some of the yml files and add comments

.github/workflows/release.yml → .github/workflows/build-release-package.yml

@@ -1,4 +1,4 @@
-name: Build and create a Release
+name: Build Release Package
 
 on:
   push:
@@ -76,10 +76,12 @@ jobs:
           echo RELEASE_PATH=./src/${{env.PROJECT_NAME}}/bin/publish/${{env.RELEASE_NAME}} >> $GITHUB_ENV
           cd ./src/${{env.PROJECT_NAME}}/bin/publish/
           tar cvzf ${{env.RELEASE_NAME}} *
+    
       - name: Package (Windows)
         if: matrix.os == 'windows-latest'
         run: |
           Compress-Archive -Path .\src\${{env.PROJECT_NAME}}\bin\publish\* -DestinationPath .\${{env.RELEASE_NAME}}
+      
       - name: Package (Mac)
         if: matrix.os == 'macos-latest'
         run: |

.github/workflows/build.yml → .github/workflows/create-version-tag.yml

@@ -1,4 +1,4 @@
-name: Build and create version tag
+name: Create Version Tag
 
 on:
   push:
@@ -60,6 +60,10 @@ jobs:
       - name: Unit Test
         run: dotnet test -v=normal -c ${{env.BUILD_CONFIGURATION}} ${{env.SOLUTION_PATH}}
 
+      # this will check if the file 'Directory.Build.props' has changed,
+      # and if yes it creates a version tag which will trigger a 
+      # deployment processes of 3 steps:
+      #    version creation -> draft release package -> deployment mainet/testnet/signet
       - name: Check for changes in Directory.Build.props
         if: matrix.os == 'ubuntu-latest'
         id: check_changes

.github/workflows/docker-release.yml → .github/workflows/docker-deploy.yml

@@ -1,4 +1,4 @@
-name: Build and Release Docker Image
+name: Deploy Docker Image
 on:
   release:
     types: [published, prereleased]

.github/workflows/gh-deploy-test.yml

@@ -1,4 +1,4 @@
-name: Deploy Test to Github Pages
+name: Deploy to Github Pages Test
 
 on:
   push:

.github/workflows/gh-deploy.yml

@@ -1,4 +1,4 @@
-name: Deploy Release to Github Pages
+name: Deploy to Github Pages Mainnet
 
 on:
   push: