updating docs with more information