update the api docs with more formatting and minor content changes