Rework documentation a little.

This will make it easier to document the new functionality.
Add read_requirements_from_file helper function.
Merge branch 'feature/add-read-req-file' into develop
docs: Explain he problem with setup_requires.
Bump version to 1.0.2.
Merge branch 'release/1.0.2'