add notes for service refactor