improved doc on new methods and 2.2 changes