Initial version of the v1 api doc needs peer review