new notes for RC1
updated notes
Merge branch 'api_cleanup'