more api documentation
refactored resource classes