Updates documentation based on Caroline's feedback