operators: Improve docs

Signed-off-by: Michael Buesch <m@bues.ch>