update docs with a better API section