making things a bit more readable, documenting a bit, more to come