improving intro and scopes doc

usamar?