small fix (upper/lower) case
add docstrings, small refactoring
changing logger messages