integrate collection documentation regeneration

[ssbarnea]

We should integrated https://github.com/ansible-network/collection_prep into ansible-lint as a default feature for collections.

ansible-lint is already used to certify collections and having one less tool to run would only benefit everyone.

The expectation is that if the placeholders are missing we don't need to generate docs but later we could check if current repository is a collection and display a warning if the placeholders are missing.

This will likely work well even with pre-commit.ci auto-fixing.

[MarkusTeufelberger]

Please don't.

A linter should be a static code checker, not a documentation generation tool in my opinion. It would be nice to mention that other project as something that one could run of course, but they even already provide a hook for the pre-commit tool: https://github.com/ansible-network/collection_prep/blob/master/.pre-commit-hooks.yaml