better docs for scope attribute passing
Merge pull request #977 from bitovi/scope-docs

Scope docs