[installer]: document the custom annotations

[mrsimonemms]

Description

Documentation for the custom annotations. Based upon #10461 (comment)

Related Issue(s)

Fixes #10840

How to test

Read

Release Notes

NONE

Documentation

Werft options:

• /werft with-preview

[nandajavarma]

Just wondering, should we document that the user will have to do a delete --cascade=orphan on ws-manager Deployment in the given example?
Edit: If updating an existing installation, that is.

[mrsimonemms]

Just wondering, should we document that the user will have to do a delete --cascade=orphan on ws-manager Deployment in the given example? Edit: If updating an existing installation, that is.

@nandajavarma I've had a think about it and I think, that in the README at least, we probably don't want to be adding complexities. These are mostly for our team anyway.

I've made the documentation on the website more "how to get around" it. I decided against the --cascade=orphan as I don't think we should be adding that complexity if/when it goes wrong. I'd rather suggest something simple that works for customers and then they can come to us when they have specific needs

[mrsimonemms]

I'm actually going to close this - we have it in the website and there's nothing unique in here