docs: clarify Error semantic
docs: clarify Error semantic

Two aspects were not spelled out explicitly, which sometimes led to
misunderstandings:

- error messages are always printed
- the error instance is optional

go-logr/logr,go-logr/logr