feat(docs): generate docs from docstrings

.github/actions/download-artifact/action.yml

@@ -38,7 +38,7 @@ runs:
  using: composite
  steps:
  - name: Download artifacts
- uses: actions/download-artifact@9bc31d5ccc31df68ecc42ccf4149144866c47d8a # v3.0.2
+ uses: actions/download-artifact@65a9edc5881444af0b9093a5e628f2fe47ea3b2e # v4.1.7
  with:
  name: ${{ inputs.name }}
  path: ${{ inputs.path }}

.github/actions/seal-restore/action.yml

@@ -43,7 +43,7 @@ runs:
  shell: bash
 
  - name: Download artifacts
- uses: actions/download-artifact@9bc31d5ccc31df68ecc42ccf4149144866c47d8a # v3.0.2
+ uses: actions/download-artifact@65a9edc5881444af0b9093a5e628f2fe47ea3b2e # v4.1.7
  with:
  name: ${{ inputs.artifact_name }}
  path: .

.github/actions/seal/action.yml

@@ -79,7 +79,7 @@ runs:
  shell: bash
 
  - name: Upload artifacts
- uses: actions/upload-artifact@0b7f8abb1508181956e8e162db84b466c27e18ce # v3.1.2
+ uses: actions/upload-artifact@65462800fd760344b1a7b4382951275a0abb4808 # v4.3.3
  with:
  if-no-files-found: error
  name: ${{ steps.export_artifact_name.outputs.artifact_name }}

.github/actions/upload-artifact/action.yml

@@ -68,7 +68,7 @@ runs:
  shell: bash
 
  - name: Upload artifacts
- uses: actions/upload-artifact@0b7f8abb1508181956e8e162db84b466c27e18ce # v3.1.2
+ uses: actions/upload-artifact@65462800fd760344b1a7b4382951275a0abb4808 # v4.3.3
  with:
  if-no-files-found: ${{ inputs.if-no-files-found }}
  name: ${{ inputs.name }}

.github/actions/upload-release-provenance/action.yml

@@ -42,7 +42,7 @@ runs:
 
  - id: download-provenance
  name: Download newly generated provenance
- uses: actions/download-artifact@9782bd6a9848b53b110e712e20e42d89988822b7 # v3.0.1
+ uses: actions/download-artifact@65a9edc5881444af0b9093a5e628f2fe47ea3b2e # v4.1.7
  with:
  name: ${{ inputs.provenance_name }}
 

.github/workflows/build_changelog.yml

@@ -17,8 +17,8 @@ on:
 # branches:
 # - develop
  schedule:
- # Note: run daily at 7am UTC time until upstream git-chlog uses stable sorting
- - cron: "0 7 * * *"
+ # Note: run daily at 10am UTC time until upstream git-chlog uses stable sorting
+ - cron: "0 10 * * *"
 
 permissions:
  contents: read

.github/workflows/codeql-analysis.yml

@@ -28,7 +28,7 @@ jobs:
 
  steps:
  - name: Checkout repository
- uses: actions/checkout@0ad4b8fadaa221de15dcec353f45205ec38ea70b # v4.1.4
+ uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
 
  # Initializes the CodeQL tools for scanning.
  - name: Initialize CodeQL

.github/workflows/dependency-review.yml

@@ -17,6 +17,6 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: 'Checkout Repository'
- uses: actions/checkout@0ad4b8fadaa221de15dcec353f45205ec38ea70b # v4.1.4
+ uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
  - name: 'Dependency Review'
- uses: actions/dependency-review-action@5bbc3ba658137598168acb2ab73b21c432dd411b # v4.2.5
+ uses: actions/dependency-review-action@5a2ce3f5b92ee19cbb1541a4984c76d921601d7c # v4.3.4

.github/workflows/label_pr_on_title.yml

@@ -50,7 +50,7 @@ jobs:
  pull-requests: write # label respective PR
  steps:
  - name: Checkout repository
- uses: actions/checkout@0ad4b8fadaa221de15dcec353f45205ec38ea70b # v4.1.4
+ uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
  - name: "Label PR based on title"
  uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
  env:

.github/workflows/on_closed_issues.yml

@@ -21,7 +21,7 @@ jobs:
  permissions:
  issues: write # comment on issues
  steps:
- - uses: aws-actions/closed-issue-message@8b6324312193476beecf11f8e8539d73a3553bf4
+ - uses: aws-actions/closed-issue-message@80edfc24bdf1283400eb04d20a8a605ae8bf7d48
  with:
  repo-token: "${{ secrets.GITHUB_TOKEN }}"
  message: |

.github/workflows/on_label_added.yml

@@ -47,7 +47,7 @@ jobs:
  permissions:
  pull-requests: write # comment on PR
  steps:
- - uses: actions/checkout@0ad4b8fadaa221de15dcec353f45205ec38ea70b # v4.1.4
+ - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
  # Maintenance: Persist state per PR as an artifact to avoid spam on label add
  - name: "Suggest split large Pull Request"
  uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1

.github/workflows/on_merged_pr.yml

@@ -49,7 +49,7 @@ jobs:
  issues: write # label issue with pending-release
  if: needs.get_pr_details.outputs.prIsMerged == 'true'
  steps:
- - uses: actions/checkout@0ad4b8fadaa221de15dcec353f45205ec38ea70b # v4.1.4
+ - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
  - name: "Label PR related issue for release"
  uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
  env:

.github/workflows/on_opened_pr.yml

@@ -47,7 +47,7 @@ jobs:
  needs: get_pr_details
  runs-on: ubuntu-latest
  steps:
- - uses: actions/checkout@0ad4b8fadaa221de15dcec353f45205ec38ea70b # v4.1.4
+ - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
  - name: "Ensure related issue is present"
  uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
  env:
@@ -66,7 +66,7 @@ jobs:
  permissions:
  pull-requests: write # label and comment on PR if missing acknowledge section (requirement)
  steps:
- - uses: actions/checkout@0ad4b8fadaa221de15dcec353f45205ec38ea70b # v4.1.4
+ - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
  - name: "Ensure acknowledgement section is present"
  uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
  env:

.github/workflows/on_schedule_monthly_roadmap_reminder.yml

@@ -2,17 +2,21 @@ name: Monthly roadmap reminder
 
 on:
  workflow_dispatch: {}
-# schedule:
-# - cron: '0 0 1 * *'
+  schedule:
+  - cron: '0 0 1 * *' # runs first day of the month
 
 permissions:
  contents: read
- pull-requests: read
- issues: read
 
 
 jobs:
  call-workflow-passing-data:
- uses: aws-powertools/actions/.github/workflows/monthly_roadmap_reminder.yml@fd4575466e5c2ac10703ac16f5aa9fb8890f532a
- with:
- token: ${{ github.token }}
+ permissions:
+ contents: read
+ pull-requests: read
+ issues: write # create monthly roadmap report
+
+ # setting to `@main` until we have releases and governance installed
+ uses: aws-powertools/actions/.github/workflows/monthly_roadmap_reminder.yml@main
+ secrets:
+ token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/ossf_scorecard.yml

@@ -22,20 +22,20 @@ jobs:
 
  steps:
  - name: "Checkout code"
- uses: actions/checkout@0ad4b8fadaa221de15dcec353f45205ec38ea70b # v4.1.4
+ uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
  with:
  persist-credentials: false
 
  - name: "Run analysis"
- uses: ossf/scorecard-action@0864cf19026789058feabb7e87baa5f140aac736 # v2.3.1
+ uses: ossf/scorecard-action@62b2cac7ed8198b15735ed49ab1e5cf35480ba46 # v2.4.0
  with:
  results_file: results.sarif
  results_format: sarif
  publish_results: true # publish to OSSF Scorecard REST API
  repo_token: ${{ secrets.SCORECARD_TOKEN }} # read-only fine-grained token to read branch protection settings
 
  - name: "Upload results"
- uses: actions/upload-artifact@65462800fd760344b1a7b4382951275a0abb4808 # v4.3.3
+ uses: actions/upload-artifact@50769540e7f4bd5e21e526ee35c689e35e0d6874 # v4.4.0
  with:
  name: SARIF file
  path: results.sarif