more docs

just adding doc info and a change to an error.