refactored testing code into tests/ directory
added some useful comments to the various requirements files to make it clear where things should be added
added README for the examples directory