better docs around scope
merged site