Investigate why we are not able to use https://doc.crds.dev/ for generating crd docs, and fix it

**Describe the solution you'd like**
Make necessary changes to the project to be able to use doc.crds.dev.

**What is the added value?**
Would be very nice to have an autogenerated CRD docs for our CRDs.

**Give us examples of the outcome**

Works for multiple repos: https://twitter.com/hasheddan/status/1351254486581473281/retweets/with_comments

Not working with ours.
