Reordered definitions to match the API reference, and rewrote usage notes in the README