[WIP] Document component flags

[irbekrm]

Document cert-manager component flags.

The markdown files have been generated with https://github.com/jetstack/cert-manager/tree/master/tools/cobra from v1.4.0 tag.

This is the initial commit- after this gets merged, I would like to add a Prow pre-submit that PRs in an update to these files automatically (when files in cert-manager/cmd/ change).

Signed-off-by: irbekrm irbekrm@gmail.com

[jetstack-bot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: irbekrm

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

• OWNERS [irbekrm]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[wallrj]

@irbekrm

Thanks for doing this. I've often wondered how Kubernetes turn the Cobra command line help into Markdown documents.

I noticed that the menu items are duplicated in the main page and look a bit ugly

How about we call this "Command Line Reference" and put it alongside the API docs under a new "Reference" top-level menu item.
Not my idea, just copying the Kubernetes layout: https://kubernetes.io/docs/reference/command-line-tools-reference/kubelet/

[irbekrm]

Thanks @wallrj

How about we call this "Command Line Reference" and put it alongside the API docs under a new "Reference" top-level menu item.
Not my idea, just copying the Kubernetes layout: https://kubernetes.io/docs/reference/command-line-tools-reference/kubelet/

That makes sense. I will put that and the API reference docs under /Reference.
Marking this PR as WIP as I need to figure out how to generate kubectl plugin docs too cert-manager/cert-manager#4265 (comment)

[jetstack-bot]

@irbekrm: PR needs rebase.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

[wallrj]

Supplanted by #800