add markdown, from requirements, for api docs