fixes #337 - add and document api ordering
Merge pull request #469 from groovecoder/api-ordering

fixes #337 - add and document api ordering