better documentation of methods and code refactoring. cleaner triggering of rendering