adding refactor notes to api doc