removed a little bit of code smell
added docs to the functions I worked with