updated documentation in 3 files