chore(docs): improve api methods description