[FEATURE] Auto-generate API Reference Docs

[adambkaplan]

Is there an existing feature request for this?

• I have searched the existing feature requests

Is your feature request related to a problem or use-case? Please describe.

API reference materials provide the necessary foundation for good documentation. Ideally these reference docs are automatically generated from the code itself.

Describe the solution that you would like.

1. Use a tool, such as crd-ref-docs, to auto-generate documentation from source code.
2. Add a separate "Reference" section of the docs for the auto-generated material. This should be separate from the current material.

Describe alternatives you have considered.

Keep the current approach of adding "reference" materials to the existing doc articles. This causes us to overload our doc articles with reference material and "how to" material mixed together.

Anything else?

Much of this recommendation came from LF/CNCF materials:

• CNCF Sandbox Primer
• LF course Creating Effective Documentation for Developers

[adambkaplan]

Credit to @nate-double-u for pointing me to the sandbox primer and sending me down this path.