Document initial api

The plan is to document the initial api methods and use the PR to get everyone's feedback on how the api should look before starting on the implementation.
It's really hard to parse graphite's query language, so we shouldn't do that unless it's absolutely necessary. (I've tried it in the past and spent a whole bunch of effort getting nowhere.)