Add more textual explanation in api doc