updated descriptions in some classes
updated the documentation