DOC: organise API reference

[lucascolley]

We have a bit of a mish-mash of functions in the main API reference page at the moment. This is fine for now, but as the API grows it would be helpful to break them up into meaningful categories, e.g. 'creation functions', like the standard does.