improving intro and scopes doc

:+1: