improved api doc