a little extra doc refactor