Apply coding guidelines

add lots of doc comments
move misfits out of master and into seperate branch to add it later again