add some rspec to example and more inline comments to get things clearer - see #3

[skip ci]