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.

@jessehouwing
Thanks so much for opening a PR! I'll get this triaged for review ⚡

Some issues with this way of displaying:

For YAML blocks setting the highlighting to powershell the wrong keywords are highlighted.

And it's unclear that this is PowerShel Core 6+ (pwsh) instead of Windows PowerShell 5 and below.

In the legacy example the difference is even more important.

@jessehouwing -- Thanks for the feedback!

For YAML blocks setting the highlighting to powershell the wrong keywords are highlighted.

We don't currently have a way to correctly render multiple languages within the same codeblock 🤔 We're finding that the codeblock titles for "Shell" and "PowerShell" are useful for letting us distinguish them, and saves us from having to keep each example in a separate subsection -- this would occupy a lot more screen space and make it difficult for users to scan through the content.

And it's unclear that this is PowerShel Core 6+ (pwsh) instead of Windows PowerShell 5 and below.

I've added intro text for each of these examples, to make it clearer which version is being referenced. Unfortunately our docs site doesn't let us easily add new languages.

Status update: docs engineering are investigating the staging issue

For some reason this header doesn't render as it's supposed to on the preview environment:

## Echoing command outputs

For some reason this header doesn't render as it's supposed to on the preview environment:

## Echoing command outputs

Looks like your commit fixed it 😄 🎊

Following up on the content plan consideration described here: #15354 (comment)

@martin389 We have an issue that @skedwards88 recently opened to define guidelines for using the tool picker that we should address before adding more tools to it, so that we have a shared understanding for when it's appropriate for the platform overall to include a tool.

Thanks @emilyistoofunky, I've added the reasoning for the two new tools to @skedwards88's issue 👍

This is looking ready to ship 🚢 🎊 Just doing some final checks.

Thanks very much for contributing! Your pull request has been merged 🎉 You should see your changes appear on the site in approximately 24 hours. If you're looking for your next contribution, check out our help wanted issues ⚡

@jessehouwing - Thanks again for this great PR, PowerShell users are definitely going to appreciate this update ✨

Changes are now live: https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions ⚡