document the new platforms version of this API