improve documentation and fix spelling errors
use JSON capitalization consistently
SpecTransform -> SpecDriven in readme
Merge pull request #69 from norbertpotocki/documentation

Documentation improvements