updates docs related to new API 2RC2