API documentation

[keewis]

Still missing:

• [x] grid info objects

[keewis]

While the API docs are not perfect (they're missing examples, for example), I think we have the bare minimum for releasing, and either way we can always improve in later PRs.