tweaked doucmentation on API