code refactorign, added api methods description for the Enhancements 1.2 functionality