Some documentation fixes and better explanation of assistant roles