added a few extra explanatory notes