updating documentation and refactoring some obsolete parameters