Sitelet https://github.com/lightspeedwp/.github/issues/3481
Skip to content

chore(ci): documentation.yml staleness step is a no-op stub #3481

Description

@eleshar

Problem

.github/workflows/documentation.yml, step Identify stale documents (id: staleness, audit job), is a stub. It loops over every README.md and only prints Checking staleness for <file>.... It checks no age, sets no outputs and reports nothing, but it still runs whenever AUDIT_SCOPE is all or staleness.

Change

Either implement the check or remove the step:

  • Implement: use git log -1 --format=%ct -- <file> to flag READMEs untouched for more than 6 months. Write a count output and a job-summary table, and add a test for the script.
  • Or remove the step and the staleness scope value, if nobody consumes it.

Acceptance

  • The step produces a result someone can act on, or it no longer exists.
  • actionlint clean.

Found during #3478.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Fields

    Priority

    None yet

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions