Polish comments a bit

Author: etiennestuder

.github/actions/gradle/download/action.yml

@@ -1,9 +1,9 @@
 name: Download latest release
-description: "Download latest release"
+description: "Downloads the latest release of the build validation scripts for Gradle"
 
 inputs:
   token:
-    description: "Github token"
+    description: "GitHub token"
     required: false
 
 runs:
@@ -16,18 +16,18 @@ runs:
           authHeader="--header 'Authorization: Bearer ${{ inputs.token }}'"
         fi
 
-        # Build Get Latest release data command
+        # Build the command to get the details of the latest version of the build validation scripts
         cmdGetLatestReleaseData="curl -s $authHeader https://api.github.com/repos/gradle/gradle-enterprise-build-validation-scripts/releases/latest"
 
-        # Get latest release download url
+        # Get the download url of the latest version of the build validation scripts
         downloadUrl=$($cmdGetLatestReleaseData | jq -c '.assets[] | select(.content_type == "application/zip")' | jq -r .browser_download_url | grep -v maven)
 
-        # Build Get Latest release command
+        # Build the command to download the latest version of the build validation scripts
         cmdGetLatestRelease="curl -s -L $authHeader -o gradle-enterprise-gradle-build-validation.zip $downloadUrl"
 
-        # Get latest release
+        # Download the latest version of the build validation scripts
         eval "$cmdGetLatestRelease"
 
-        # Unzip it
+        # Unzip the downloaded build validation scripts
         unzip -q -o gradle-enterprise-gradle-build-validation.zip
       shell: bash