Docs: Catalogd API reference

[perdasilva]

Write Catalogd API reference documentation. Sync with @michaelryanpeter to see if there are any tools that can go from godoc to the API reference. Another option might to source the information from the CRD which is in openAPI format. There might already be tools to process that. (See what k8s does here: https://kubernetes.io/docs/contribute/generate-ref-docs/kubernetes-api/)

• ClusterCatalog API reference documentation

Current documentation is posted up at https://operator-framework.github.io/operator-controller/
New docs should be placed in docs/drafts

Note

This documentation should be written after operator-framework/catalogd#239

[michaelryanpeter]

Docs generation tooling for the downstream OpenShift client: https://github.com/openshift/oc/tree/master/tools/gendocs