updating docs to use new prefered methods