[DOC] update README and GUIDES

to match current API's