issue #3: updating documentation new format and classy other things