Rephrasing the documentation notes for the new API functions