lots pylint fixes, add documentation