scaladoc and config comments

Signed-off-by: Mikolaj Szabo <savingprivateblue@gmail.com>