added document for APIs designed and used in code