review comments on API dev guide is incorporated