make test: improve documentation and PEP8 compliance