Where should we document the new play argspec?

So if you haven’t seen it yet, play argument specification validation is coming in ansible-core. There’s also a draft doc for this, with an open question for us -

How/where should we add documentation for this? The current draft docs PR includes it in the intro to playbooks page, under the validating playbooks heading.

We could keep it there and link to it from other places, as the PR suggests.

Do you have other thoughts on where this new feature should be documented?

3 Likes