feat: add optional github-token input to generate_terraform_docs workflow

[jansdhillon]

Applicable spec: #966

Overview

Adds an optional github-token input to the generate_terraform_docs workflow so callers can supply a PAT instead of the default GITHUB_TOKEN.

Rationale

GitHub prevents workflows from being triggered by commits or PRs created using GITHUB_TOKEN. This means that when terraform-docs opens or updates a PR, no CI workflows run against it. By allowing callers to pass a PAT, CI can be triggered on the resulting PR.

Workflow Changes

• Added github-token input (type: string, default: "") to generate_terraform_docs.yaml under workflow_call.inputs.
• Updated the Create pull request step to use ${{ inputs.github-token || secrets.GITHUB_TOKEN }}, preserving backwards compatibility.

Checklist

• The contributing guide was applied
• The PR is tagged with appropriate label (urgent, trivial, complex) - pls tag trivial
• The changelog is updated with user-relevant changes in the format of keep a changelog v1.1.0

[yanksyoon]

Hello! Im afraid this would lead to a secrets leak (security issue), would you try inheriting the secret instead? https://docs.github.com/en/actions/how-tos/reuse-automations/reuse-workflows#using-inputs-and-secrets-in-a-reusable-workflow

[alithethird]

I agree with Yanks on this.

[jansdhillon]

Hi, I've changed it to a secrets block instead

[github-actions]

Test results for commit 1bcee9a

Test coverage for 1bcee9a

Name           Stmts   Miss Branch BrPart  Cover   Missing
----------------------------------------------------------
src/charm.py       8      8      0      0     0%   8-25
----------------------------------------------------------
TOTAL              8      8      0      0     0%

Static code analysis report

Run started:2026-03-23 03:51:28.457444+00:00

Test results:
  No issues identified.

Code scanned:
  Total lines of code: 56
  Total lines skipped (#nosec): 0
  Total potential issues skipped due to specifically being disabled (e.g., #nosec BXXX): 0

Run metrics:
  Total issues (by severity):
  	Undefined: 0
  	Low: 0
  	Medium: 0
  	High: 0
  Total issues (by confidence):
  	Undefined: 0
  	Low: 0
  	Medium: 0
  	High: 0
Files skipped (0):

[github-actions]

Test results for commit 1bcee9a

Test coverage for 1bcee9a

Name           Stmts   Miss Branch BrPart  Cover   Missing
----------------------------------------------------------
src/charm.py       8      8      0      0     0%   8-25
----------------------------------------------------------
TOTAL              8      8      0      0     0%

Static code analysis report

Run started:2026-03-23 03:51:32.783828+00:00

Test results:
  No issues identified.

Code scanned:
  Total lines of code: 56
  Total lines skipped (#nosec): 0
  Total potential issues skipped due to specifically being disabled (e.g., #nosec BXXX): 0

Run metrics:
  Total issues (by severity):
  	Undefined: 0
  	Low: 0
  	Medium: 0
  	High: 0
  Total issues (by confidence):
  	Undefined: 0
  	Low: 0
  	Medium: 0
  	High: 0
Files skipped (0):

[github-actions]

Test results for commit 1bcee9a

Test coverage for 1bcee9a

Name           Stmts   Miss Branch BrPart  Cover   Missing
----------------------------------------------------------
src/charm.py       8      8      0      0     0%   8-25
----------------------------------------------------------
TOTAL              8      8      0      0     0%

Static code analysis report

Run started:2026-03-23 03:56:11.875901+00:00

Test results:
  No issues identified.

Code scanned:
  Total lines of code: 56
  Total lines skipped (#nosec): 0
  Total potential issues skipped due to specifically being disabled (e.g., #nosec BXXX): 0

Run metrics:
  Total issues (by severity):
  	Undefined: 0
  	Low: 0
  	Medium: 0
  	High: 0
  Total issues (by confidence):
  	Undefined: 0
  	Low: 0
  	Medium: 0
  	High: 0
Files skipped (0):