addressing review comments
docs: using code from the test dir
Merge pull request #2 from yet-another-user/master

gh-pages update