Enhance permission comments

Author: Malcolmnixon

.github/workflows/build.yaml

@@ -16,8 +16,8 @@ on:
 jobs:
   build:
     permissions:
-      contents: read
-      pull-requests: write
+      contents: read       # To read repository contents
+      pull-requests: write # To write pull requests analysis results and artifacts
 
     runs-on: ${{ inputs.os }}
 

.github/workflows/build_on_push.yaml

@@ -7,8 +7,8 @@ jobs:
   build-windows:
     name: Build Windows
     permissions:
-      contents: read
-      pull-requests: write
+      contents: read       # To read repository contents
+      pull-requests: write # To write pull requests analysis results and artifacts
     uses: ./.github/workflows/build.yaml
     with:
       os: windows-latest
@@ -19,8 +19,8 @@ jobs:
   build-linux:
     name: Build Linux
     permissions:
-      contents: read
-      pull-requests: write
+      contents: read       # To read repository contents
+      pull-requests: write # To write pull requests analysis results and artifacts
     uses: ./.github/workflows/build.yaml
     with:
       os: ubuntu-latest

.github/workflows/release.yaml

@@ -22,8 +22,7 @@ jobs:
   build:
     name: Build Linux
     permissions:
-      contents: read
-      pull-requests: write
+      contents: write # To create releases
     uses: ./.github/workflows/build.yaml
     with:
       os: ubuntu-latest