In which we add much-deserved API documentation

Depends upon https://github.com/freedomgames/parklab/pull/8

@maiamcguinness @wilhow