add optional scope parameter
test and doc scope parameter
Merge pull request #1 from guybrush/master

optional scope parameter