updated interface and in code comments