Document example custom resources

[MarkusH]

While the code provides the full CustomResourceDefinition the documentation is lacking clear examples of what is possible and what not. E.g. a very simple custom resource with only the required arguments, a more advanced one that shows some possibilities, and a complex one, making use of all available options.