added notes with API examples for the next version