UseCompatibleSyntax.md Documentation Out of Date

[franklesniak]

It appears that the documentation UseCompatibleSyntax.md is out of date. I say this because the markdown file lists 6.0 as the newest version that can be checked, but this page shows 6.2: DevBlogs Post About PSScriptAnalyzer

Also, I presume 7.0 is also supported by this point?

Can this page be updated to show the versions that can be checked? Thanks in advance!

[bergmeister]

As per PSSA 1.19.0 release post here, PowerShell 7 syntax support has been added (mainly in PR #1331 and #1426). The markdown doc is more of an example but should be enhanced to include all supported versions for that rule or at least the maximum supported version of the last PSSA release.

@rjmholt Looking at the code, here and here it seems that the rule only takes the major versions internally only anyway. Not much of an issue atm because it's a hidden implementation detail with no impact to the user but that will probably have to change for PowerShell 7.1/7.2

[franklesniak]

You confirmed what I suspected after reviewing that same code, i.e., that only major versions matter (3.0 - 7.0). Thanks for that - it gets me by for now.

[rjmholt]

that only major versions matter

That's true so long as new syntax isn't introduced in a minor version; the rule is based on syntactic changes made from version to version, and so far no minor version has introduced new syntaxes.

[NLZ]

Not sure if this issue should still be used, but for the record 7.3 added clean to script block, so people would might be interested in testing for it.