added more explanatory notes