Skip to content

status: reference docs don't clarify its usage #2752

@aieri

Description

@aieri

Description

https://taskfile.dev/docs/reference/schema#status describes a method for detecting whether a task should run or be skipped. Unfortunately it doesn't describe how task uses the output of the specified status command.
Based on the example provided, I can guess the idea is that if the status command has a RC of 0 the task is skipped, and if it does not the task is run, but the documentation doesn't say this. Without the example one could also imagine other behaviors:

  • run task if status command produces output on stdout
  • run task if status command produces output that differs from the last invocation
  • run task if status command produces output on stderr, ignoring RC

I suggest clarifying intent so that it may be understood without having to infer it from the example.

Version

3.49.1

Operating system

Any

Experiments Enabled

No response

Example Taskfile

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions