updated documentation,  still work in progress. code fix