Improvements to documentation and tests

Tests modified for readability, plus an improved README