fix indentation
add documenation and try to use meaningful names