copied documentation markdown from api_docs branch