initial discussion of scope in the docs