updating docs on parameters