documentation fixes; extra tests
Merge pull request #631 from georgebyelas/master

documentation fixes; extra tests