Background: We are moving upstream best-practices guide to downstream documentation and as part of that process, evaluating what should and shouldn't migrate, along with asking what is out of date.

The CRD relationship diagram here was developed long ago and we need an updated diagram. I'm not sure that it's required to have all the fields as part of the diagram, but rather to show the relationships between the CRDs, and then we can refer to the API reference that has also been produced since this diagram was originally developed.

This diagram belongs probably in our project upstream documentation first as the golden source, which today is the mig-operator repo, and then we can source that downstream. (CC: dwhatley does that make sense to you, in terms of location? I could also see this in the controller potentially).

https://redhat-cop.github.io/openshift-migration-best-practices/05-troubleshooting.html#mtc-custom-resources

API documentation Jira MIG-253

CC: apinnick@redhat.com