Better docs

Author: mathbunnyru

.github/actions/cmake/action.yml

@@ -60,6 +60,8 @@ runs:
         # GitHub creates merge commits for PRS, so we:
         # - explicitly provide branch name
         # - provide `github.head_ref` to get the actual commit SHA of the PR branch.
+        #
+        # This way it works both for PRs and pushes to branches.
         GITHUB_BRANCH_NAME: "${{ github.head_ref || github.ref_name }}"
         GITHUB_HEAD_SHA: "${{ github.event.pull_request.head.sha || github.sha }}"
       run: |

cmake/ClioVersion.cmake

@@ -25,7 +25,7 @@ else ()
   )
 
   if (DEFINED ENV{GITHUB_BRANCH_NAME})
-    # Please, see cmake action in .github/actions/ for details
+    # Please, see .github/actions/cmake/action.yml for details
     set(BRANCH $ENV{GITHUB_BRANCH_NAME})
     set(GITHUB_HEAD_SHA $ENV{GITHUB_HEAD_SHA})
     string(SUBSTRING ${GITHUB_HEAD_SHA} 0 7 REV)