add description block

Author: sthulb

.github/workflows/update_ssm.yml

@@ -1,3 +1,17 @@
+# SSM Parameters update
+#
+# PROCESS
+# Creates parameters in regional AWS accounts for each layer we create, using the inputs to target specific releases
+# * environment: will prefix /beta/ into the parameter
+# * write_latest: will create a latest alias instead of a version number in the parameter
+# * package_version: semantic version number of the released layer (3.x.y)
+# * layer_version: this is sequential layer version from the ARN
+#
+# A successful parameter would look similar to:
+#   /aws/service/powertools/python/arm64/python3.8/3.1.0
+# And will have a value of:
+#   arn:aws:lambda:eu-west-1:017000801446:layer:AWSLambdaPowertoolsPythonV3-python38-arm64:4
+
 on:
   workflow_dispatch:
     inputs:
@@ -25,7 +39,7 @@ on:
         required: true
 
 name: SSM Parameters
-run-name: SSM Parameters - ${{ inputs.language }}
+run-name: SSM Parameters - Python
 
 permissions:
   contents: read
@@ -43,17 +57,17 @@ jobs:
             "il-central-1", "me-central-1", "me-south-1", "sa-east-1", "us-east-1",
             "us-east-2", "us-west-1", "us-west-2", "ap-southeast-5"
           ]
-    
+
     permissions:
       contents: write
       id-token: write
     steps:
       - id: transform
         run: |
-          echo 'CONVERTED_REGION=${{ matrix.region }}' | tr [a-z\-] [A-Z_] >> "$GITHUB_OUTPUT"
+          echo 'CONVERTED_REGION=${{ matrix.region }}' | tr 'a-z\-' 'A-Z_' >> "$GITHUB_OUTPUT"
       - id: creds
         uses: aws-actions/configure-aws-credentials@e3dd6a429d7300a6a4c196c26e071d42e0343502
-        with: 
+        with:
           aws-region: ${{ matrix.region }}
           role-to-assume: ${{ secrets[format('{0}', steps.transform.outputs.CONVERTED_REGION)] }}
           mask-aws-account-id: true
@@ -76,9 +90,9 @@ jobs:
           aws ssm put-parameter --name ${{ env.prefix }}/python/x86_64/python3.13/${{ inputs.package_version }} --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python313-x86_64:${{ inputs.layer_version }}" --type String
 
       - id: write-latest
-        if: inputs.write_latest == true 
+        if: inputs.write_latest == true
         env:
-          prefix: ${{ inputs.environment == 'beta' && '/aws/service/powertools/beta' || '/aws-service/powertools' }} 
+          prefix: ${{ inputs.environment == 'beta' && '/aws/service/powertools/beta' || '/aws-service/powertools' }}
         run: |
           aws ssm put-parameter --name ${{ env.prefix }}/python/arm64/python3.8/latest --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python38-arm64:${{ inputs.layer_version }}" --type String
           aws ssm put-parameter --name ${{ env.prefix }}/python/arm64/python3.9/latest --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python39-arm64:${{ inputs.layer_version }}" --type String