updates docs with scope changes