updated the gems
documentation improvements and  updates