proposed clarifications
Merge pull request #10 from jlopp/proposedImprovements

proposed clarifications