ci: better comments in github actions

.github/workflows/build-and-bump.yml

@@ -2,8 +2,8 @@ name: Build, bump version numbers, and update changelog
 
 on:
   push:
-    branches: [main] # not on insider release branch
-    paths: [source/**] # only for build for source files
+    paths: [source/**] # only trigger action when source files were changed
+    branches: [main] # do not trigger on other the insider-release branch
   workflow_dispatch: # allows manually triggering on github
 
 permissions:
@@ -17,7 +17,7 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-        # by default, no tags and only a single commit is fetched. To use git
+        # By default, no tags and only a single commit is fetched. To use git
         # history in the changelog step, we need to fetch all history.
         with:
           fetch-depth: 0 # 0 = all history
@@ -27,6 +27,9 @@ jobs:
 
       - name: Build
         run: |
+          # Due to globbing, the source files are inserted in alphabetical order.
+          # To keep things predictable, they are simply number in the order they
+          # should be included in.
           cat ./source/*.css <(echo "/* @settings") ./source/style-settings.yaml <(echo "*/") \
             > ./theme.css