Skip to content

publish-single-page-docs action.yml fails to parse — unquoted colon in github-token description #39

Description

@oto-macenauer-absa

Summary

The reusable action actions/publish-single-page-docs/action.yml fails to load at runner "Set up job" time. Any workflow consuming the action fails immediately (~4s), before any step runs.

Observed in

AbsaOSS/organizational-workflows "Publish Docs" workflow run https://github.com/AbsaOSS/organizational-workflows/actions/runs/30910992670, consuming the action at SHA 679ec07.

Exact Error

```
##[error]AbsaOSS/knowledge-base/679ec075cab1e1cdfb1140eedad7f2f80a5b683a/actions/publish-single-page-docs/action.yml:
(Line: 26, Col: 73, Idx: 944) - (Line: 26, Col: 73, Idx: 944):
Mapping values are not allowed in this context.
##[error]System.ArgumentException: Unexpected type '' encountered while reading 'action manifest root'. The type 'MappingToken' was expected.
##[error]Failed to load AbsaOSS/knowledge-base/679ec075cab1e1cdfb1140eedad7f2f80a5b683a/actions/publish-single-page-docs/action.yml
```

Root Cause

Line 26 of actions/publish-single-page-docs/action.yml:

```yaml
description: Token used to upload the release asset. Needs `contents: write`.
```

The plain (unquoted) scalar contains `contents: write` — the `: ` after `contents` makes the YAML parser treat it as a nested mapping, which is invalid in that context. Backticks have no quoting meaning in YAML.

Proposed Fix

Quote the string, e.g.:

```yaml
description: 'Token used to upload the release asset. Needs `contents: write`.'
```

Alternatively use double-quote or fold with `>-`. Optionally add YAML lint/validation of action manifests to CI to prevent regressions.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions