docs: describe handling of optional logger parameters
docs: describe handling of optional logger parameters

At some point we discussed whether APIs where the logger is optional should use
"Logger" and document that it might be the null logger or use "*Logger". We
settled on the later, but don't seem to have that written down.

go-logr/logr,go-logr/logr