doc: improve descriptions

Author: stefanvogel

.github/workflows/main.yml

@@ -11,10 +11,10 @@ on:
     branches: [ '**' ]
 
   release:
-    # A release, pre-release, or draft of a release is published.
+    # Runs when a release, pre-release, or draft of a release is published.
     types: [ published ]
 
-  # Allows you to run this workflow manually from the Actions tab.
+  # Can be run 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.