updated doc about using scopes.