minor documentation fixes
convert requirements-*.txt to be inclusive; flake8 script introduced