updated documentation and github pointers