added a bit more docs + indented