updating docs to be more understandable