Skip to content

fix(ci): Add permissions to Generate-Documentation workflow #616

Description

@kcenon

What

Add permissions: contents: write to the build-Doxygen.yaml caller workflow to fix startup_failure on every push/PR.

Current Behavior

The Generate-Documentation workflow fails with startup_failure (0 jobs created) because the caller workflow lacks the required permissions block for the reusable workflow at kcenon/common_system/.github/workflows/doxygen.yml@main.

Expected Behavior

Workflow succeeds and deploys documentation to GitHub Pages.

Why

GitHub Actions requires caller workflows to explicitly declare permissions when invoking reusable workflows that need elevated token access. The reusable doxygen.yml needs contents: write for peaceiris/actions-gh-pages@v4 deployment.

  • Root cause: Introduced when reusable workflow pattern was adopted
  • Proven fix: pacs_system applied identical fix on 2026-03-18 (commit e559995f)

Where

  • .github/workflows/build-Doxygen.yaml

How

Add permissions block between on: and jobs: sections:

permissions:
  contents: write

Acceptance Criteria

  • build-Doxygen.yaml includes permissions: contents: write
  • Generate-Documentation workflow passes on next push to main

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    priority/highHigh priority - Critical for productionsize/XStype/buildBuild system and dependencies

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions