updating documentation both in code and readmes