updated docs - ready 2 merge