Ensure the doctoc tool works

[killianmuldoon]

Cluster API uses the doctoc tool to ensure a table of contents is generated for certain markdown files. It looks like the script and the make target it calls are not working correctly - at least with the version of doctoc I installed. It seems that it is not able to run doctoc against the set of files as passed in the script.

Additionally we should increase the number of files covered by this make target. Currently those markdown files are hardcoded. The hack/verify-doctoc.sh script should be updated so that it generates tables of contents correctly for all proposals in the CAPI repo - i.e all the markdown files in docs/proposals

c/f #9112 (comment)

[sbueringer]

/triage accepted

/help

[k8s-ci-robot]

@sbueringer:
This request has been marked as needing help from a contributor.

Guidelines

Please ensure that the issue body includes answers to the following questions:

• Why are we solving this issue?
• To address this issue, are there any code changes? If there are code changes, what needs to be done in the code and what places can the assignee treat as reference points?
• Does this issue have zero to low barrier of entry?
• How can the assignee reach out to you for help?

For more details on the requirements of such an issue, please see here and ensure that they are met.

If this request no longer meets these requirements, the label can be removed
by commenting with the /remove-help command.

In response to this:

/triage accepted

/help

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.

[sbueringer]

/assign