more docs and new methods