added ordering comment and rearranged description and code sample
Merge pull request #2 from p4yne/master

added ordering comment and rearranged description and code sample