upgrade docs

maybe put this under warning:: ?