Open TheRealFalcon opened 2 hours ago
I'm in favor of removing the cloud-init schema --docs
command entirely. The documentation is a few clicks away and I don't think it's reasonable to expect full module documentation on the CLI.
The alternative is to ship the module docs in the cloud-init package and then update the parsing to use those rather than the old-style doc generation.
It is broken, and its benefit was marginal, so I'm not sure that a fix would be worth it.
Anybody that wants docs locally can always just do something like: git clone ...; tox -e doc; xdg-open doc/rtd_html/index.html
cloud-init schema --docs
used to output something similar to our modules docs, but since a recent refactor (plus some follow-up PRs), we only get the docstrings of the python modules in a format that is unreadable: