VPA: Generate API docs

[adrianmoisey]

What type of PR is this?

/kind documentation

What this PR does / why we need it:

Adds a script to generate API docs using crd-ref-docs

I did try use gen-crd-api-reference-docs to generate docs, but I struggled to get the templating working nicely with markdown, so I switched to crd-ref-docs.

The ordering of gen-crd-api-reference-docs is nicer, and I'd like to use it, but gave up after some time.

Which issue(s) this PR fixes:

Fixes #

Special notes for your reviewer:

Does this PR introduce a user-facing change?

Additional documentation e.g., KEPs (Kubernetes Enhancement Proposals), usage docs, etc.:

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: adrianmoisey
Once this PR has been reviewed and has the lgtm label, please assign raywainman for approval. For more information see the Kubernetes Code Review Process.

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

Needs approval from an approver in each of these files:

• vertical-pod-autoscaler/OWNERS

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

[omerap12]

Just one comment. otherwise looks good to me

[omerap12]

can we do something about those duplicated lines?

[adrianmoisey]

The first one comes from here:

autoscaler/vertical-pod-autoscaler/pkg/apis/autoscaling.k8s.io/v1/doc.go

Line 19 in 7df4f84

// Package v1 contains definitions of Vertical Pod Autoscaler related objects.

The second one comes from here:

autoscaler/vertical-pod-autoscaler/pkg/apis/autoscaling.k8s.io/v1/types.go

Line 17 in 7df4f84

// Package v1 contains definitions of Vertical Pod Autoscaler related objects.

Looking at other projects and their docs, I think it's fine to remove the comment from types.go, what do you think?