API documentation

**What would you like to be added**:

Better documentation of the API(s), preferable by auto-generating with e.g. https://github.com/elastic/crd-ref-docs. We'd need to document `api/nfd` and `api/image-compatibility`.

**Why is this needed**:

Better documentation, always up-to-date (if auto-generated)