improving intro and scopes doc

Sounds like very clear now. ++