Ensure generated docs/crds for kubewarden/docs are submitted automatically

[viccuad]

Acceptance criteria

Ensure doc files generated by make generate-crd-docs generate-kwctl-cli-docs are automatically submitted to the github.com/kubewarden/docs repo so they are included in versioned cuts of the docs.

This can be done by using updatecli, or by shipping this files as byproducts of an adm-controller release in the GH release artifacts, and consuming from the docs repo for example.

[viccuad]

Blocked on kubewarden/docs#748.

[viccuad]

This is now unblocked.

[viccuad]

The existing make generate-kwctl-cli-docs in adm-controller repo currently generates markdown only, using a rust library clap-markdown embedded in the kwctl binary itself. Currently there's no clap library that generates ascii docs.

Hence, I propose that we keep consuming the current markdown ./crates/kwctl/cli-docs.md, and upon consumption, we transform them with pandoc or similar to asciidocs.

This would need to happen in the existing updatecli workflow in the docs repo, which should get its updatecli policy config updated.

[jvanz]

From my memory, I though that the clap-markdown crate is able to generate Asciidocs. But I was wrong. I have a false memory because I've opened an issue asking for this feature. Therefore, we need to find another way to convert this into asciidoc. Actually, I found that I've opened an issue in the past to cover this as well forecasting the asciidoc migration.