I don't believe that the logging documentation is particularly unclear,
though of course it could always be improved, like most other
documentation ;-)

It certainly does not rely on prior experience of log4j; though some of
the concepts are similar, the details are not.

As per Facundo's comment, I'll certainly look at documentation patches -
but I'll close this issue for now. If you would like to reopen, please
submit a patch with specific suggested improvements.