[doc] hannes added doc strings + better debug output
[doc] cleanup