improved documentation
improved desriptions