update documentation and normalize clases