updating tutorial according to changes in the category API
updating javadocs