more docs for #161