logging: start documenting API and other bits

Signed-off-by: Fabio M. Di Nitto <fdinitto@redhat.com>