Document Object Element Dereference Syntax

[Kurt-von-Laven]

Code of Conduct

• I have read and agree to the GitHub Docs project's Code of Conduct

What article on docs.github.com is affected?

Expressions: Object filters

What part(s) of the article would you like to see updated?

The section on object filters can be read to give the impression that the * syntax can only be used on arrays, but it can also be used on objects. Consider adding an example illustrating the use and behavior of * with objects.

Additional information

For example, as documented by slack-templates, ${{ needs.*.result }} evaluates to an array of the results of the jobs that the current job directly depends on even though needs is an object, not an array. Disclosure: I am the author of slack-templates. The existing documentation resulted in a bug in Actionlint: rhysd/actionlint#66.

[ramyaparimi]

@Kurt-von-Laven
Thanks so much for opening an issue! I'll triage this for the team to take a look 👀

[skedwards88]

Thanks for this suggestion! This sounds like an excellent addition to the docs. You or anyone else is welcome to make this change.