What problem are you facing?

There is documentation on every field of the CRDs and this is really awesome. However, in many cases resources create a connection secret that includes the credential to use the resource such as root user credentials for MySQLInstance resources. But there isn't really a documentation that tells you what the keys of those secrets are or what each of them means.

How could Crossplane help solve your problem?

Just like CRD documentation, Crossplane docs could have a section that shows the format of the connection secret and what to expect for each managed resource. Ideally, this'd be auto-generated like the CRD doc.

Edit (@jbw976): This problem domain is likely solved in a complete way for the Crossplane ecosystem by:

• [v2] Introduce a ManagedResourceDefinition type #2262