Message why job artifact buttons are missing on jobs page

Problem to solve

When a path for a job artifact isn't defined the Download and Browse buttons are hidden. This is confusing for users who may not see the job fail, like code quality, and not know why they can't see the resulting artifact.

I don't know why there are no buttons to browse or download to a job artifact on the jobs page and need help.

Intended users

Further details

After better documentation about how to properly setup a code quality job so the download artifact is available and removing the Keep button there is confusion about how to get the artifact on the jobs page.

Proposal

Add some help text, link, other, to the jobs page when an artifact was created BUT no Keep, Download, Browse buttons are present because the artifacts:paths was not defined. This should point users to the docs page that talks about troubleshooting and proper setup.

Outcomes

  • When I did not set an artifacts:paths value, i want to see helper text on the jobs page, so that I know how to get a job artifact properly.

Permissions and Security

None.

Documentation

The documentation for code quality may need an update for a more comprehensive troubleshooting section.

Testing

What does success look like, and how can we measure that?

Acceptance Criteria

  • When a code quality job runs but no artifact:path is set the text appears
  • When a SAST job runs but no artifact:path is set the text appears but is contextual for that job

What is the type of buyer?

Links / references

Edited by James Heimbuck