added discussion on scopes, closes #7