devonfw#427: renamed jobs

renamed jobs and added comments

Author: jan-vcapgemini

.github/workflows/nightly-build.yml

@@ -17,8 +17,9 @@ jobs:
         if: ${{ (github.event_name == 'schedule') || (github.event_name == 'workflow_dispatch') }}
         run: echo '::set-output name=RUN_BUILD::'$(test -n "$(git log --format=%H --since='24 hours ago')" && echo 'true' || echo 'false')
 
+  # Builds documentation pdf file and uploads artifact to docs
   build-documentation:
-    name: Build documentation and upload to natives
+    name: Build documentation
     needs: [ verify_commit ]
     if: ${{ needs.verify_commit.outputs.RUN_BUILD == 'true' }}
     runs-on: ubuntu-latest
@@ -39,9 +40,9 @@ jobs:
           name: docs
           path: cli/target/package/*.pdf
 
-
+  # Downloads documentation, builds all native images, archives native images and documentation and uploads artifacts to f.e. natives-windows-latest
   build-natives:
-    name: Build native images with downloaded documentation
+    name: Build native images
     needs: [ verify_commit, build-documentation ]
     if: ${{ needs.verify_commit.outputs.RUN_BUILD == 'true' }}
     runs-on: ${{ matrix.os }}
@@ -74,6 +75,7 @@ jobs:
           name: natives-${{ matrix.os }}
           path: cli/target/*.tar.gz
 
+  # Downloads all native image artifacts and builds the project for deployment to OSS Nexus
   deploy:
     name: Build Project and Deploy
     needs: [ verify_commit, build-documentation, build-natives ]