docs and some batch method deprecation