Add missing 'skipped' option to needs

[Aebrathia]

Why:

I found out that the needs.<job id>.result context in Github Actions has an undocumented option skipped when the job dependency is skipped.

What's being changed:

I added 'skipped' to the list of possible values.

Check off the following:

• All of the tests are passing.
• I have reviewed my changes in staging.
• For content changes, I have reviewed the localization checklist
• For content changes, I have reviewed the Content style guide for GitHub Docs.

[welcome]

Thanks for opening this pull request! A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

[janiceilene]

Thanks for opening a PR @Aebrathia! I'll get this triaged for review ✨

[lucascosti]

@Aebrathia Thanks a lot for this PR!

It took me a little while to figure out if it was even possible for a job that needs a skipped job to actually run in order to see the context. but I did eventually get a workflow run that resulted in the output (using if: ${{ always() }} 😁) :

https://github.com/lucascosti/actions-public-playground/runs/1246235670?check_suite_focus=true#step:3:13

I'll get this PR merged in 🚀

[Aebrathia]

@lucascosti thanks for your review, glad to know about Oxford commas.

The issue you faced is a bit tricky and needs a bit doc digging. Default if: value is ${{ success() && your_custom_if_condition }} unless you explicitely use a job status check function (like I did below).

name: Deploy
jobs:
  update:
    if: # should update deployment configuration
    steps:
      - run: # update project
  deploy:
    needs: update
    if: ${{ success() || needs.update.result == 'skipped' }} # Deploy even if no update (manual redeploy…)
    steps:
      - run: # deploy

[janiceilene]

@Aebrathia If you haven't already, you can add yourself to the list of contributors by creating a new comment in this PR using these instructions. Thanks again! ✨

[lucascosti]

The issue you faced is a bit tricky and needs a bit doc digging. Default if: value is ${{ success() && your_custom_if_condition }} unless you explicitely use a job status check function (like I did below).

Ah, of course! Yes, I forgot about situation where needs can just serialize jobs, rather than only for strict dependencies. 😁