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

better docs for scope attribute passing