Think about the target audience and check if the current explanation in documentation and inline YAML comments suffice #254
Description
After an internal demonstration, it seemed that the current explanations in the inline YAML comments might not suffice to service all audiences. We should think about the target audience and which assumptions we make in the knowledge this audience already has.