Improved documentation for the new APIs a bit