updated docs - ready to merge