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