API updates

Updated document with API changes made based on James Peach's review.