now that scopes work, added brainstormed documentation