logging: documentation update

* Includes logging documentation in main documentation.

* Fixes minor issues in logging documentation.

* Fixes some PEP257 problems.

Signed-off-by: Lars Holm Nielsen <lars.holm.nielsen@cern.ch>