updates, documentation and fading output