Better docs

Author: mathbunnyru

.github/actions/cmake/action.yml

@@ -57,9 +57,12 @@ runs:
         STATIC: "${{ inputs.static == 'true' && 'ON' || 'OFF' }}"
         TIME_TRACE: "${{ inputs.time_trace == 'true' && 'ON' || 'OFF' }}"
         PACKAGE: "${{ inputs.package == 'true' && 'ON' || 'OFF' }}"
-        # GitHub creates merge commits for PRS, so we:
+        # GitHub creates a merge commit for a PR
+        # https://www.kenmuse.com/blog/the-many-shas-of-a-github-pull-request/
+        #
+        # We:
         # - explicitly provide branch name
-        # - provide `github.head_ref` to get the actual commit SHA of the PR branch.
+        # - use `github.head_ref` to get the SHA of last commit in the PR branch
         #
         # This way it works both for PRs and pushes to branches.
         GITHUB_BRANCH_NAME: "${{ github.head_ref || github.ref_name }}"