update docs with change to scoping