Documentation generation for functions/resources

[purpleidea]

Problem:

Our end users will likely want to get information on the available resources, functions, and constants. Let's make the documentation story better.

Issues:

It is possible to get information about the resources from reading the godoc page, but it is not in the ideal format for non-golang programmers to review. We'd also like to get information about the functions and constants. That information can be queried from an internal API. (We will add a .D (documentation) sub-field for that.)

We'd like to combine all of this information into simple, clear documentation which we can push to a statically generated website somewhere (html/markdown/text?) or even output in the terminal.

Architecture:

You should write a command to mgmt (maybe mgmt doc) that provides some mechanisms/flags to generate this documentation.

If you have questions please ask here!