first round of api docs.