various updates including adding scopes, a bit of clean up, and a readme update