updated documentation to show new scope levels