These docs are not autogenerated. They are generated from specially formated
markdown files that need to be updated when flags are changed but nobody knows
about this so it is not enforced. Thus the man page generation is not useful.
For the sake of having up to date docs up to date for v1, I am manually udating
the markdown files and removing the md2man generation. After v1 we need to gen
this man pages with the rest of our generated docs in a pre commit hook so that
they are not able to become out of date. We can do this by converting our daemons
to use cobra cmd like kubectl.
This does away with the giant dump from cobra for kubectl and instead
generates md files which contain similar information, but one per verb.
This might work well as part of the cobra project, instead of doing it
in kube, but this gets us nice, linked, documentation right now. If
people like it, I will try to get something similar into cobra.
Manjunath A Kumatagi