Improve README and in-code documentation (godoc style)

[#77046628]

Signed-off-by: Georg Apitz <gapitz@pivotal.io>