added document for public api